функция обратного вызова DXGKCB_GETHANDLEPARENT (d3dkmddi.h)
DXGKCB_GETHANDLEPARENT извлекает родительский ресурс из указанного выделения.
Синтаксис
DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;
D3DKMT_HANDLE DxgkcbGethandleparent(
[in] IN_D3DKMT_HANDLE hAllocation
)
{...}
Параметры
[in] hAllocation
Дескриптор выделения. Этот дескриптор должен быть дескриптором режима ядра ядра DirectX, назначенным подсистеме ядра 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 (include D3dkmddi.h) |
| IRQL | < DISPATCH_LEVEL |