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.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista |
Piattaforma di destinazione | Desktop |
Intestazione | dispmprt.h |
IRQL | PASSIVE_LEVEL |