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

  • Статья

DXGKCB_GETHANDLEPARENT извлекает родительский ресурс из указанного выделения.

Синтаксис

DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;

D3DKMT_HANDLE DxgkcbGethandleparent(
  [in] IN_D3DKMT_HANDLE hAllocation
)
{...}

Параметры

[in] hAllocation

Дескриптор выделения. Этот дескриптор должен быть дескриптором режима ядра графики DirectX (Dxgkrnl.sys), назначенным для выделения.

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

DXGKCB_GETHANDLEPARENT возвращает дескриптор, зависящий от подсистемы графики, в родительский ресурс для выделения, связанного с дескриптором, заданным параметром hAllocation .

Если DXGKCB_GETHANDLEPARENT возвращает дескриптор NULL, Dxgkrnl.sys не удалось разрешить дескриптор в родительский ресурс по следующим причинам:

  • Недопустимый дескриптор был получен от драйвера отображения пользовательского режима из-за вредоносной атаки или другой ошибки.
  • При выделении были проблемы со временем существования.

Если возвращается дескриптор NULL, драйвер минипорта дисплея должен завершить работу своей текущей функции DDI с STATUS_INVALID_HANDLE.

Комментарии

Чтобы DXGKCB_GETHANDLEPARENT возвращать дескриптор ресурса, дескриптор в hAllocation должен быть дескриптором выделения, связанным с ресурсом; В противном случае DXGKCB_GETHANDLEPARENT возвращает значение NULL.

DXGKCB_XXX функции реализуются dxgkrnl. Чтобы использовать эту функцию обратного вызова, вызовите DxgkCbGetHandleParent через DXGKRNL_INTERFACE.

Требования

Требование Значение
Минимальная версия клиента Windows Vista (WDDM 1.0)
Целевая платформа Персональный компьютер
Верхняя часть d3dkmddi.h (включая D3dkmddi.h)
IRQL < DISPATCH_LEVEL

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

DXGKRNL_INTERFACE