функция обратного вызова LPD3DHAL_CONTEXTDESTROYCB (d3dhal.h)

Функция D3dContextDetextDe json удаляет указанный контекст.

Синтаксис

LPD3DHAL_CONTEXTDESTROYCB Lpd3dhalContextdestroycb;

DWORD Lpd3dhalContextdestroycb(
  LPD3DHAL_CONTEXTDESTROYDATA unnamedParam1
)
{...}

Параметры

unnamedParam1

pcdd [in]

Указывает на структуру D3DHAL_CONTEXTDESTROYDATA, содержащую сведения, необходимые драйверу для уничтожения контекста.

Возвращаемое значение

D3dContextDetextDe json возвращает один из следующих кодов обратного вызова:

Замечания

Все драйверы Microsoft Direct3D должны поддерживать D3dContextDetextDesk.

Драйвер должен освободить все ресурсы, выделенные для контекста, который удаляется. Например, драйвер должен освободить следующие ресурсы, связанные с контекстом:

Драйвер не должен освободить поверхности Microsoft DirectDraw, связанные с контекстом, так как они будут освобождены DirectDraw в ответ на запрос приложения или среды выполнения Direct3D.

Если драйвер кэшировал указатель на структуру DD_DIRECTDRAW_LOCAL, передаваемую в качестве элемента lpDDDLcl структуры D3DHAL_CONTEXTCREATEDATA при вызове D3dContextCreate, указатель может стать недопустимым до вызова D3dContextDetext. Таким образом, D3dContextDetext Не должно разыменовывать этот указатель DD_DIRECTDRAW_LOCAL, так как нарушение доступа может привести к возврату или случайным данным. Например, если функция драйвера D3dDetextDDLocal вызывается перед вызовом D3dContextDetextDesk, операционная система освобождает этот указатель DD_DIRECTDRAW_LOCAL перед вызовом D3dContextDe textDesk.

D3dContextDetextDesk можно вызвать с отключенным PDEV. PDEV отключен или включен путем вызова функции драйвера дисплея DrvAssertMode. Дополнительные сведения см. в управлении PDEV.

Требования

Требование Ценность
целевая платформа Настольный
заголовка d3dhal.h (include D3dhal.h)

См. также

D3DHAL_CONTEXTCREATEDATA

D3DHAL_CONTEXTDESTROYDATA

D3dContextCreate

D3dDeskDDLocal

DD_DIRECTDRAW_LOCAL

  • Last updated on