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 de retour
DXGKCB_ENUMHANDLECHILDREN retourne le handle Dxgkrnlspécifique à l’allocation enfant décrite pData. Pour récupérer les données spécifiques à l’appareil pour le handle, le pilote de 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 façon inattendue un handle NULL, le sous-système du noyau graphique DirectX n’a pas pu résoudre le handle sur 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é de façon inattendue, le pilote miniport d’affichage doit échouer à 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 basés sur zéro. Si le pilote display miniport définit pData->Index sur 0, DXGKCB_ENUMHANDLECHILDREN retourne le premier handle d’allocation ; si d’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.
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 | PASSIVE_LEVEL |