DXGKCB_GETHANDLEPARENT funzione di callback (d3dkmddi.h)
DXGKCB_GETHANDLEPARENT recupera la risorsa padre dall'allocazione specificata.
Sintassi
DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;
D3DKMT_HANDLE DxgkcbGethandleparent(
[in] IN_D3DKMT_HANDLE hAllocation
)
{...}
Parametri
[in] hAllocation
Handle per un'allocazione. Questo handle deve essere l'handle in modalità kernel assegnato dal sottosistema kernel della grafica DirectX (Dxgkrnl.sys) per l'allocazione.
Valore restituito
DXGKCB_GETHANDLEPARENT restituisce un handle specifico del sottosistema grafico per la risorsa padre per l'allocazione associata all'handle specificato dal parametro hAllocation.
Se DXGKCB_GETHANDLEPARENT restituisce un handle NULL, Dxgkrnl.sys non è stato in grado di risolvere l'handle nella risorsa padre per un motivo come le possibilità seguenti:
- Un handle non valido è stato ricevuto dal driver di visualizzazione in modalità utente a causa di un attacco dannoso o di un altro bug.
- Le allocazioni hanno avuto problemi di durata.
Se viene restituito un handle NULL, il driver miniport di visualizzazione non riesce con la funzione DDI attualmente in esecuzione con STATUS_INVALID_HANDLE.
Osservazioni
Affinché DXGKCB_GETHANDLEPARENT restituisca un handle di risorsa, l'handle in hAllocation deve essere un handle di allocazione associato a una risorsa; in caso contrario, DXGKCB_GETHANDLEPARENT restituisce NULL.
DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, chiamare DxgkCbGetHandleParent tramite il DXGKRNL_INTERFACE.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista (WDDM 1.0) |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | < DISPATCH_LEVEL |