DXGKCB_GETHANDLEPARENT fonction de rappel (d3dkmddi.h)
DXGKCB_GETHANDLEPARENT récupère la ressource parente de l’allocation spécifiée.
Syntaxe
DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;
D3DKMT_HANDLE DxgkcbGethandleparent(
[in] IN_D3DKMT_HANDLE hAllocation
)
{...}
Paramètres
[in] hAllocation
Handle vers une allocation. Ce handle doit être le handle en mode noyau que le sous-système du noyau graphique DirectX (Dxgkrnl.sys) affecté pour l’allocation.
Valeur de retour
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 vers la ressource parente 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 ont rencontré des problèmes de durée de vie.
Si un handle NULL est retourné, le pilote miniport d’affichage doit é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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista (WDDM 1.0) |
| plateforme cible | Bureau |
| d’en-tête | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | < DISPATCH_LEVEL |