DXGKDDI_QUERY_CHILD_STATUS funzione di callback (dispmprt.h)

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 a un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver di visualizzazione ha fornito in precedenza questo handle al sottosistema del kernel della grafica DirectX.

[in, out] ChildStatus

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

[in] NonDestructiveOnly

Valore BOOLEAN che specifica se il driver miniport visualizzato è consentito per determinare lo stato richiesto in modo da causare artefatti visivi. Se il chiamante imposta questo parametro su TRUE, il driver miniport visualizzato non è consentito per causare artefatti. Se il chiamante imposta questo parametro su FALSE, il driver miniport visualizzato 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.

Commenti

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 il 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 hardware esterno connesso a esso; in caso contrario, restituisce FALSE.
  • Se ChildStatus->Type è uguale a StatusRotation, restituire (in ChildStatus->Rotation.Angle) l'angolo di rotazione per la visualizzazione connessa al dispositivo figlio identificato da ChildStatus->ChildUid.
DxgkDdiQueryChildStatus deve essere reso paginabile.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Piattaforma di destinazione Desktop
Intestazione dispmprt.h
IRQL PASSIVE_LEVEL

Vedi anche

DXGK_CHILD_STATUS

DXGK_CHILD_STATUS_TYPE

DxgkDdiQueryChildRelations