DXGKDDI_QUERY_CHILD_RELATIONS fonction de rappel (dispmprt.h)

Article
05/23/2024

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

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 d’un bloc de contexte associé à un adaptateur d’affichage. La fonction DxgkDdiAddDevice du pilote miniport d’affichage a 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és et mis à zéro par l’appelant. Le nombre d’éléments dans le tableau est supérieur à la valeur retournée par DxgkDdiStartDevice dans le paramètre NumberOfChildren . DxgkDdiQueryChildRelations doit remplir toutes les structures du tableau sauf la dernière avec des informations décrivant les périphériques enfants de la carte graphique. La dernière structure du tableau doit rester à zéro.

[in] ChildRelationsSize

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

Valeur retournée

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 périphériques externes qui se connectent à l’adaptateur graphique 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.