DXGKDDI_QUERY_CHILD_STATUS fonction de rappel (dispmprt.h)

Article
02/06/2025

La fonction DxgkDdiQueryChildStatus retourne l’état d’un appareil enfant individuel d’un adaptateur d’affichage.

Syntaxe

DXGKDDI_QUERY_CHILD_STATUS DxgkddiQueryChildStatus;

NTSTATUS DxgkddiQueryChildStatus(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] INOUT_PDXGK_CHILD_STATUS ChildStatus,
  [in]      IN_BOOLEAN NonDestructiveOnly
)
{...}

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

[in, out] ChildStatus

Pointeur vers une structure DXGK_CHILD_STATUS. L’appelant fournit ChildStatus->Type et ChildStatus->ChildUid. En retour, le membre de structure restant (une union) reçoit l’état demandé.

[in] NonDestructiveOnly

Valeur BOOLEAN qui spécifie si le pilote miniport d’affichage est autorisé à déterminer l’état demandé de manière à provoquer des artefacts visuels. Si l’appelant définit ce paramètre sur TRUE, le pilote miniport d’affichage n’est pas autorisé à provoquer des artefacts. Si l’appelant définit ce paramètre sur FALSE, le pilote miniport d’affichage est autorisé à provoquer des artefacts.

Valeur de retour

DxgkDdiQueryChildStatus retourne STATUS_SUCCESS si elle réussit ; sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

Lors de l’initialisation, le pilote de port d’affichage appelle DxgkDdiQueryChildRelations pour obtenir la liste des appareils qui sont des enfants de l’adaptateur d’affichage représenté par MiniportDeviceContext. Ensuite, pour chaque enfant qui a une valeur de sensibilisation HPD de HpdAwarenessPolled ou HpdAwarenessInterruptible, le pilote de port d’affichage appelle DxgkDdiQueryChildStatus pour déterminer si l’enfant a actuellement du matériel (par exemple un moniteur) connecté à celui-ci.

DxgkDdiQueryChildStatus devez effectuer les actions suivantes :

Si ChildStatus->Type est égal à StatusConnection, retournez une valeur booléenne dans ChildStatus->HotPlug.Connected. Retournez TRUE si l’appareil enfant identifié par ChildStatus->ChildUid a un matériel externe connecté à celui-ci ; sinon, retournez FAUX.
Si ChildStatus->Type est égal à StatusRotation, retournez (dans ChildStatus->Rotation.Angle) l’angle de rotation de l’affichage connecté à l’appareil enfant identifié par ChildStatus->ChildUid.

DxgkDdiQueryChildStatus doit être rendu paginable.