DXGKCB_GETHANDLEPARENT fonction de rappel (d3dkmddi.h)
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 |