DXGKDDI_GET_CHILD_CONTAINER_ID fonction de rappel (dispmprt.h)

  • Article

Interroge l’ID de conteneur pour la cible spécifiée. Implémenté par windows Display Driver Model (WDDM) 1.2 et versions ultérieures, affichez les pilotes miniports.

Syntaxe

DXGKDDI_GET_CHILD_CONTAINER_ID DxgkddiGetChildContainerId;

NTSTATUS DxgkddiGetChildContainerId(
  [in]      PVOID MiniportDeviceContext,
  [in]      ULONG ChildUid,
  [in, out] PDXGK_CHILD_CONTAINER_ID ContainerId
)
{...}

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 Microsoft DirectX.

[in] ChildUid

Valeur ULONG qui identifie de manière unique l’appareil enfant. Le pilote miniport d’affichage a précédemment fourni cet identificateur lorsque sa fonction DxgkDdiQueryChildRelations a été appelée.

[in, out] ContainerId

Pointeur vers une structure DXGK_CHILD_CONTAINER_ID . Pour plus d'informations, consultez la section Notes.

Valeur retournée

Retourne l’un des codes d’erreur suivants.

Code de retour Description
STATUS_SUCCESS Le pilote a mis à jour la structure pointée vers le paramètre ContainerId avec des informations d’ID de conteneur obtenues à partir du matériel d’affichage.
STATUS_MONITOR_NODESCRIPTOR Le pilote a accepté les informations d’ID de conteneur par défaut fournies dans la structure pointée par ContainerId. Note: Si le pilote retourne ce code status, il ne doit pas modifier la structure.

Sinon, la fonction retourne l’un des codes status définis dans Ntstatus.h.

Remarques

Le système d’exploitation appelle la fonction DxgkDdiQueryChildRelations du pilote d’affichage miniport pour énumérer les appareils enfants de la carte d’affichage. Le système d’exploitation appelle ensuite la fonction DxgkDdiQueryDeviceDescriptor du pilote d’affichage pour chaque appareil enfant afin d’obtenir l’EDID (Extended Display Information Data) pour l’appareil. Pour plus d’informations sur cette procédure, consultez Énumération des appareils enfants d’un adaptateur d’affichage.

En fonction des données EDID de l’appareil, le système d’exploitation génère un ID de conteneur par défaut pour l’appareil enfant. Ensuite, le système d’exploitation appelle la fonction DxgkDdiGetChildContainerId du pilote miniport d’affichage et passe un pointeur vers une structure DXGK_CHILD_CONTAINER_ID via le paramètre ContainerId . Le membre ContainerId de cette structure contient l’ID de conteneur par défaut de l’appareil d’affichage enfant.

Le pilote miniport d’affichage peut accepter l’ID de conteneur par défaut ou définir le membre ContainerId sur un identificateur unique pour l’appareil avant qu’il ne retourne à partir de l’appel à DxgkDdiGetChildContainerId.

Pour plus d’informations sur les ID de conteneur, consultez Id de conteneur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8
Serveur minimal pris en charge Windows Server 2012
Plateforme cible Desktop (Expérience utilisateur)
En-tête dispmprt.h
IRQL PASSIVE_LEVEL

Voir aussi

DXGK_CHILD_CONTAINER_ID

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

DxgkDdiQueryDeviceDescriptor