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

Статья
02/26/2024

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

Синтаксис

LPD3DHAL_CONTEXTDESTROYCB Lpd3dhalContextdestroycb;

DWORD Lpd3dhalContextdestroycb(
  LPD3DHAL_CONTEXTDESTROYDATA unnamedParam1
)
{...}

Параметры

unnamedParam1

pcdd [in]

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

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

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 .