DXGKDDI_CONTROLINTERRUPT funzione di callback (d3dkmddi.h)

La funzione DxgkDdiControlInterrupt abilita o disabilita il tipo di interruzione specificato nell'hardware della grafica.

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 tipo che fornisce il tipo di interruzione.

[in] EnableInterrupt

Valore booleano che indica se DxgkDdiControlInterrupt abilita o disabilita il tipo di interruzione 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 interruzione è stato abilitato o disabilitato nell'hardware grafico.
STATUS_NOT_IMPLEMENTED DxgkDdiControlInterrupt non supporta l'abilitazione o la disabilitazione del tipo di interruzione specificato.

Commenti

La funzione DxgkDdiControlInterrupt del driver di visualizzazione può abilitare o disabilitare il tipo di interruzione specificato. Tuttavia , DxgkDdiControlInterrupt non è necessario disabilitare il tipo di interruzione se il driver richiede il tipo di interruzione per uno scopo interno. Una chiamata a DxgkDdiControlInterrupt per abilitare il tipo di interruzione specificato indica che il sistema operativo richiede che il driver chiami la funzione DxgkCbNotifyInterrupt per segnalare quando il tipo di interruzione viene attivato nell'hardware grafico.

Attualmente, il sottosistema kernel della grafica Microsoft DirectX specifica solo il tipo di interruzione DXGK_INTERRUPT_CRTC_VSYNC nel parametro InterruptType . Una chiamata a DxgkDdiControlInterrupt per abilitare il tipo di interruzione DXGK_INTERRUPT_CRTC_VSYNC indica che il driver controlla l'interruzione verticale. Durante ogni periodo di ripetizione verticale e immediatamente dopo l'indirizzo di superficie primario specificato nel registro livello dati viene latched e analizzato, l'interruzione deve essere attivata e segnalata.

Il driver deve restituire STATUS_NOT_IMPLEMENTED se viene fornito un tipo di interruzione diverso da DXGK_INTERRUPT_CRTC_VSYNC.

DxgkDdiControlInterrupt deve essere reso paginabile.

Requisiti

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

Vedi anche

DXGK_INTERRUPT_TYPE

DxgkCbNotifyInterrupt

DxgkDdiAddDevice