DXGKDDI_QUERY_CHILD_STATUS funzione di callback (dispmprt.h)

Articolo
02/06/2025

La funzione DxgkDdiQueryChildStatus restituisce lo stato di un singolo dispositivo figlio di una scheda di visualizzazione.

Sintassi

DXGKDDI_QUERY_CHILD_STATUS DxgkddiQueryChildStatus;

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

Parametri

[in] MiniportDeviceContext

Handle per un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver miniport di visualizzazione ha fornito in precedenza questo handle al sottosistema del kernel grafico DirectX.

[in, out] ChildStatus

Puntatore a una struttura DXGK_CHILD_STATUS. Il chiamante fornisce ChildStatus->Type e ChildStatus->ChildUid. In caso di restituzione, il membro della struttura rimanente (un'unione) riceve lo stato richiesto.

[in] NonDestructiveOnly

Valore BOOLEAN che specifica se il driver del miniport di visualizzazione è autorizzato a determinare lo stato richiesto in modo che causi artefatti visivi. Se il chiamante imposta questo parametro su TRUE, il driver miniport di visualizzazione non è autorizzato a causare artefatti. Se il chiamante imposta questo parametro su FALSE, il driver miniport di visualizzazione può causare artefatti.

Valore restituito

DxgkDdiQueryChildStatus restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Osservazioni

Durante l'inizializzazione, il driver della porta di visualizzazione chiama DxgkDdiQueryChildRelations per ottenere un elenco di dispositivi figlio della scheda di visualizzazione rappresentata da MiniportDeviceContext. Quindi per ogni figlio che ha un valore di consapevolezza HPD di HpdAwarenessPolled o HpdAwarenessInterruptible, il driver della porta di visualizzazione chiama DxgkDdiQueryChildStatus per determinare se l'elemento figlio ha attualmente hardware (ad esempio un monitor) connesso.

DxgkDdiQueryChildStatus deve eseguire le azioni seguenti:

Se ChildStatus->Type è uguale a StatusConnection, restituire un valore booleano in ChildStatus->HotPlug.Connected. Restituisce TRUE se il dispositivo figlio identificato da ChildStatus->ChildUid ha un hardware esterno connesso; in caso contrario, restituire FALSE.
Se ChildStatus->Type è uguale a StatusRotation, return (in ChildStatus->Rotation.Angle) l'angolo di rotazione per la visualizzazione connessa al dispositivo figlio identificato da ChildStatus->ChildUid.

dxgkDdiQueryChildStatus deve essere reso pageable.