DXGKDDI_QUERY_CHILD_RELATIONS fonction de rappel (dispmprt.h)

  • Article

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 d’un bloc de contexte associé à une carte d’affichage. La fonction DxgkDdiAddDevice du pilote miniport d’affichage fournissait précédemment cette poignée au sous-système du noyau graphique DirectX.

[in, out] ChildRelations

Pointeur vers un tableau de structures DXGK_CHILD_DESCRIPTOR allouées et 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 tout sauf 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 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, il 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 d’affichage ne sont pas considérés comme des appareils enfants.

Le pilote 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 comporter des descripteurs dans le tableau, même s’ils ne sont pas actuellement disponibles.

La fonction DxgkDdiQueryChildRelations doit être paginable.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête dispmprt.h
IRQL PASSIVE_LEVEL

Voir aussi

DXGK_CHILD_DESCRIPTOR

DXGK_CHILD_STATUS

DxgkDdiQueryChildStatus

DxgkDdiQueryDeviceDescriptor