DXGKDDI_GET_CHILD_CONTAINER_ID fonction de rappel (dispmprt.h)
Interroge l’ID de conteneur pour la cible spécifiée. Implémenté par le modèle de pilote d’affichage Windows (WDDM) 1.2 et versions ultérieures, affichez des pilotes miniport.
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 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 Microsoft DirectX.
[in] ChildUid
Valeur ULONG qui identifie de façon unique l’appareil enfant. Le pilote miniport d’affichage a précédemment fourni cet identificateur lorsque son DxgkDdiQueryChildRelations fonction a été appelée.
[in, out] ContainerId
Pointeur vers une structure DXGK_CHILD_CONTAINER_ID. Pour plus d’informations, consultez la section Remarques.
Valeur de retour
Retourne l’un des codes d’erreur suivants.
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | Le pilote a mis à jour la structure pointée par 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. Remarque : Si le pilote retourne ce code d’état, il ne doit pas modifier la structure. |
Sinon, la fonction retourne l’un des codes d’état définis dans Ntstatus.h.
Remarques
Le système d’exploitation appelle le du pilote miniport d’affichage DxgkDdiQueryChildRelations fonction pour énumérer les appareils enfants de l’adaptateur d’affichage. Le système d’exploitation appelle ensuite le DxgkDdiQueryDeviceDescriptor du pilote miniport d’affichage d’affichage fonction pour chaque appareil enfant afin d’obtenir les données d’informations d’affichage étendues (EDID) de l’appareil. Pour plus d’informations sur cette procédure, consultez énumération d’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 par le biais du paramètre ContainerId. Le ContainerId membre 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 de l’appel à DxgkDdiGetChildContainerId.
Pour plus d’informations sur les ID de conteneur, consultez ID de conteneur.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| serveur minimum pris en charge | Windows Server 2012 |
| plateforme cible | Bureau |
| d’en-tête | dispmprt.h |
| IRQL | PASSIVE_LEVEL |