DXGKDDI_QUERY_CHILD_RELATIONS fonction de rappel (dispmprt.h)

Article
02/06/2025

La fonction DxgkDdiQueryChildRelations énumère les appareils enfants d’une carte d’affichage.

Syntaxe

DXGKDDI_QUERY_CHILD_RELATIONS DxgkddiQueryChildRelations;

NTSTATUS DxgkddiQueryChildRelations(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] PDXGK_CHILD_DESCRIPTOR ChildRelations,
  [in]      ULONG ChildRelationsSize
)
{...}

Paramètres

[in] MiniportDeviceContext

Handle vers un bloc de contexte associé à un adaptateur d’affichage. La fonction d’affichage du pilote miniport DxgkDdiAddDevice précédemment fourni ce handle au sous-système du noyau graphique DirectX.

[in, out] ChildRelations

Pointeur vers un tableau de structures DXGK_CHILD_DESCRIPTOR allouées et nulles par l’appelant. Le nombre d’éléments du tableau est supérieur à la valeur retournée par DxgkDdiStartDevice dans le paramètre NumberOfChildren. DxgkDdiQueryChildRelations doit remplir toutes les structures, mais la dernière structure du tableau avec des informations qui décrivent les appareils enfants de l’adaptateur d’affichage. La dernière structure du tableau doit rester nulle.

[in] ChildRelationsSize

Taille totale, en octets, des ChildRelations tableau, y compris la structure zéro à la fin.

Valeur de retour

DxgkDdiQueryChildRelations retourne STATUS_SUCCESS si elle réussit ; sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

Tous les appareils enfants de l’adaptateur d’affichage sont intégrés ; les moniteurs et autres appareils externes qui se connectent à l’adaptateur d’affichage ne sont pas considérés comme des appareils enfants.

Le pilote de miniport d’affichage doit remplir un tableau de structures DXGK_CHILD_DESCRIPTOR, un pour chacun des enfants de l’adaptateur d’affichage. Le tableau doit contenir des structures DXGK_CHILD_DESCRIPTOR pour tous les appareils enfants actuels et tous les appareils enfants potentiels. Par exemple, si l’ancrage d’un ordinateur portable entraîne la mise à disposition de nouvelles sorties vidéo, ces sorties vidéo doivent avoir des descripteurs dans le tableau, même s’ils ne sont pas actuellement disponibles.

La fonction DxgkDdiQueryChildRelations doit être rendue paginable.