DXGKDDI_QUERY_CHILD_STATUS fonction de rappel (dispmprt.h)

Article
05/23/2024

La fonction DxgkDdiQueryChildStatus retourne le status d’un appareil enfant individuel d’une carte 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 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] ChildStatus

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

[in] NonDestructiveOnly

Valeur BOOLEAN qui spécifie si le pilote de miniport d’affichage est autorisé à déterminer le status demandé d’une manière qui provoque 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 retournée

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

Remarques

Pendant 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 reconnaissance 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 doit effectuer les actions suivantes :

Si ChildStatus->Type est égal à StatusConnection, retournez une valeur booléenne dans ChildStatus->HotPlug.Connected. Retourne TRUE si l’appareil enfant identifié par ChildStatus->ChildUid est connecté à du matériel externe ; sinon, retournez FALSE.
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.