DXGKDDI_CONTROLINTERRUPT funzione di callback (d3dkmddi.h)
La funzione DxgkDdiControlInterrupt abilita o disabilita il tipo di interrupt specificato nell'hardware grafico.
Sintassi
DXGKDDI_CONTROLINTERRUPT DxgkddiControlinterrupt;
NTSTATUS DxgkddiControlinterrupt(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_DXGK_INTERRUPT_TYPE InterruptType,
[in] IN_BOOLEAN EnableInterrupt
)
{...}
Parametri
[in] hAdapter
Handle per l'oggetto adapter per l'unità di elaborazione grafica (GPU). Il driver ha restituito questo handle nel parametro MiniportDeviceContext da una chiamata alla relativa funzione DxgkDdiAddDevice.
[in] InterruptType
Valore DXGK_INTERRUPT_TYPE-type che fornisce il tipo di interrupt.
[in] EnableInterrupt
Valore booleano che indica se DxgkDdiControlInterrupt abilita o disabilita il tipo di interrupt specificato. TRUE indica che abilita e false indica che disabilita.
Valore restituito
DxgkDdiControlInterrupt restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | Il tipo di interrupt è stato abilitato o disabilitato correttamente nell'hardware grafico. |
| STATUS_NOT_IMPLEMENTED | DxgkDdiControlInterrupt non supporta l'abilitazione o la disabilitazione del tipo di interrupt specificato. |
Osservazioni
La funzione DxgkDdiControlInterrupt del driver miniport di visualizzazione può abilitare o disabilitare il tipo di interrupt specificato. Tuttavia, DxgkDdiControlInterrupt non è necessario disabilitare il tipo di interrupt se il driver richiede il tipo di interrupt per uno scopo interno. Una chiamata a DxgkDdiControlInterrupt per abilitare il tipo di interrupt specificato indica che il sistema operativo richiede che il driver chiami la funzione dxgkCbNotifyInterrupt per segnalare quando il tipo di interrupt viene attivato sull'hardware grafico.
Attualmente, il sottosistema kernel della grafica Microsoft DirectX specifica solo il tipo di interrupt DXGK_INTERRUPT_CRTC_VSYNC nel parametro interruptType. Una chiamata a DxgkDdiControlInterrupt per abilitare il tipo di interrupt DXGK_INTERRUPT_CRTC_VSYNC indica che il driver controlla l'interrupt verticale. Durante ogni periodo di ritracciatura verticale e immediatamente dopo l'indirizzo della superficie primaria specificato nel registro dell'applicazione livello dati viene latch e analizzato, l'interrupt deve essere attivato e segnalato.
Il driver deve restituire STATUS_NOT_IMPLEMENTED se viene fornito un tipo di interrupt diverso da DXGK_INTERRUPT_CRTC_VSYNC.
DxgkDdiControlInterrupt deve essere reso pageable.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |