DXGKDDI_GET_CHILD_CONTAINER_ID fonction de rappel (dispmprt.h)
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 |