DXGKCB_GETHANDLEPARENT fonction de rappel (d3dkmddi.h)

  • Article

DXGKCB_GETHANDLEPARENT récupère la ressource parente à partir de l’allocation spécifiée.

Syntaxe

DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;

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

Paramètres

[in] hAllocation

Handle pour une allocation. Ce handle doit être le handle en mode noyau que le sous-système du noyau graphique DirectX (Dxgkrnl.sys) a affecté pour l’allocation.

Valeur retournée

DXGKCB_GETHANDLEPARENT retourne un handle spécifique au sous-système graphique à la ressource parente pour l’allocation associée au handle spécifié par le paramètre hAllocation .

Si DXGKCB_GETHANDLEPARENT retourne un handle NULL, Dxgkrnl.sys n’a pas pu résoudre le handle en ressource parent pour une raison telle que les possibilités suivantes :

  • Un handle non valide a été reçu du pilote d’affichage en mode utilisateur en raison d’une attaque malveillante ou d’un autre bogue.
  • Les allocations présentaient des problèmes de durée de vie.

Si un handle NULL est retourné, le pilote de miniport d’affichage doit faire échouer sa fonction DDI en cours d’exécution avec STATUS_INVALID_HANDLE.

Remarques

Pour DXGKCB_GETHANDLEPARENT retourner un handle de ressource, le handle dans hAllocation doit être un handle d’allocation associé à une ressource ; sinon, DXGKCB_GETHANDLEPARENT retourne NULL.

DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, appelez DxgkCbGetHandleParent via le DXGKRNL_INTERFACE.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista (WDDM 1.0)
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dkmddi.h (include D3dkmddi.h)
IRQL < DISPATCH_LEVEL

Voir aussi

DXGKRNL_INTERFACE