DXGKCB_ENUMHANDLECHILDREN fonction de rappel (d3dkmddi.h)
DXGKCB_ENUMHANDLECHILDREN énumère les allocations associées à une ressource donnée, une allocation à la fois.
Syntaxe
DXGKCB_ENUMHANDLECHILDREN DxgkcbEnumhandlechildren;
D3DKMT_HANDLE DxgkcbEnumhandlechildren(
[in] IN_CONST_PDXGKARGCB_ENUMHANDLECHILDREN unnamedParam1
)
{...}
Paramètres
[in] unnamedParam1
Pointeur vers une structure DXGKARGCB_ENUMHANDLECHILDREN qui décrit la ressource parente et l’index de l’allocation enfant à récupérer.
Valeur retournée
DXGKCB_ENUMHANDLECHILDREN retourne le handle spécifique à Dxgkrnl à l’allocation enfant décrite par pData . Pour récupérer les données spécifiques de l’appareil pour le handle, le pilote miniport d’affichage doit appeler la fonction DXGKCB_GETHANDLEDATA .
DXGKCB_ENUMHANDLECHILDREN retourne un handle NULL si la valeur d’index d’allocation enfant fournie dans le membre Index de la structure DXGKARGCB_ENUMHANDLECHILDREN dépasse le nombre d’allocations associées à la ressource parente. Si DXGKCB_ENUMHANDLECHILDREN retourne de manière inattendue un handle NULL, le sous-système du noyau graphique DirectX n’a pas pu résoudre le handle en 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 présentaient des problèmes de durée de vie.
Si un handle NULL est retourné de manière inattendue, le pilote miniport d’affichage doit échouer avec sa fonction DDI en cours d’exécution avec STATUS_INVALID_HANDLE.
Remarques
Un pilote miniport d’affichage peut appeler DXGKCB_ENUMHANDLECHILDREN dans une boucle pour énumérer toutes les allocations associées à une ressource.
Les index de handle d’allocation sont de base zéro. Si le pilote miniport d’affichage définit pData-Index> sur 0, DXGKCB_ENUMHANDLECHILDREN retourne le premier handle d’allocation ; si Index est défini sur 1, DXGKCB_ENUMHANDLECHILDREN retourne le deuxième handle d’allocation , et ainsi de suite. Si Index est supérieur au nombre d’allocations associées à la ressource, DXGKCB_ENUMHANDLECHILDREN retourne NULL.
DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, définissez les membres appropriés de DXGKARGCB_ENUMHANDLECHILDREN , puis appelez DxgkCbEnumHandleChildren 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 (inclure D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |