DXGKCB_ENUMHANDLECHILDREN fonction de rappel (d3dkmddi.h)

  • Article

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

Voir aussi

DXGKARGCB_ENUMHANDLECHILDREN

DXGKCB_GETHANDLEDATA

DXGKRNL_INTERFACE