DXGKCB_GETHANDLEPARENT función de devolución de llamada (d3dkmddi.h)
DXGKCB_GETHANDLEPARENT recupera el recurso primario de la asignación especificada.
Sintaxis
DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;
D3DKMT_HANDLE DxgkcbGethandleparent(
[in] IN_D3DKMT_HANDLE hAllocation
)
{...}
Parámetros
[in] hAllocation
Identificador de una asignación. Este identificador debe ser el identificador en modo kernel que el subsistema de kernel gráficos de DirectX (Dxgkrnl.sys) asignado para la asignación.
Valor devuelto
DXGKCB_GETHANDLEPARENT devuelve un identificador específico del subsistema de gráficos al recurso primario para la asignación asociada al identificador que especifica el parámetro hAllocation.
Si DXGKCB_GETHANDLEPARENT devuelve un identificador NULL, Dxgkrnl.sys no pudo resolver el identificador en el recurso primario por un motivo como las siguientes posibilidades:
- Se recibió un identificador no válido del controlador de pantalla en modo de usuario debido a un ataque malintencionado o a algún otro error.
- Las asignaciones tenían problemas de duración.
Si se devuelve un identificador NULL, el controlador de minipuerto de pantalla debe producir un error en su función DDI que se está ejecutando actualmente con STATUS_INVALID_HANDLE.
Observaciones
Para que DXGKCB_GETHANDLEPARENT devolver un identificador de recursos, el identificador de hAllocation debe ser un identificador de asignación asociado a un recurso; de lo contrario, DXGKCB_GETHANDLEPARENT devuelve NULL.
DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, llame a DxgkCbGetHandleParent a través del DXGKRNL_INTERFACE.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista (WDDM 1.0) |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dkmddi.h (incluya D3dkmddi.h) |
| irQL | < DISPATCH_LEVEL |