Поделиться через


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

Функция D3dContextDe переключение удаляет указанный контекст.

Синтаксис

LPD3DHAL_CONTEXTDESTROYCB Lpd3dhalContextdestroycb;

DWORD Lpd3dhalContextdestroycb(
  LPD3DHAL_CONTEXTDESTROYDATA unnamedParam1
)
{...}

Параметры

unnamedParam1

pcdd [in]

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

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

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

Комментарии

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

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

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

Если драйвер кэшировал указатель на структуру DD_DIRECTDRAW_LOCAL, которая была передана в качестве члена lpDDLclструктуры D3DHAL_CONTEXTCREATEDATA при вызове D3dContextCreate, указатель может стать недопустимым до вызова D3dContextDeки. Таким образом, D3dContextDeплаватель не должен разыменовыватель этого DD_DIRECTDRAW_LOCAL указателя, так как это может привести к нарушению доступа или возврату случайных данных. Например, если функция D3dDeкистройDDLocal драйвера вызывается до D3dContextDeкисло, операционная система освобождает этот указатель DD_DIRECTDRAW_LOCAL перед вызовом D3dContextDehub .

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть d3dhal.h (включая D3dhal.h)

См. также раздел

D3DHAL_CONTEXTCREATEDATA

D3DHAL_CONTEXTDESTROYDATA

D3dContextCreate

D3dDeкистройDDLocal

DD_DIRECTDRAW_LOCAL