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 a un'allocazione. Questo handle deve essere l'handle in modalità kernel assegnato al sottosistema del kernel grafico DirectX (Dxgkrnl.sys) assegnato per l'allocazione.

Valore restituito

DXGKCB_GETHANDLEPARENT restituisce un handle specifico del sottosistema grafico alla 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, ad esempio 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 visualizzato deve non riuscire la funzione DDI attualmente in esecuzione con STATUS_INVALID_HANDLE.

Commenti

Per DXGKCB_GETHANDLEPARENT restituire un handle di risorse, 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.

Requisiti

Vedi anche

DXGKRNL_INTERFACE