DXGKDDI_CONTROLINTERRUPT Rückruffunktion (d3dkmddi.h)

Die DxgkDdiControlInterrupt-Funktion aktiviert oder deaktiviert den angegebenen Interrupttyp auf der Grafikhardware.

Syntax

DXGKDDI_CONTROLINTERRUPT DxgkddiControlinterrupt;

NTSTATUS DxgkddiControlinterrupt(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_DXGK_INTERRUPT_TYPE InterruptType,
  [in] IN_BOOLEAN EnableInterrupt
)
{...}

Parameter

[in] hAdapter

Ein Handle für das Adapterobjekt für die Grafikverarbeitungseinheit (GRAPHICS Processing Unit, GPU). Der Treiber hat dieses Handle im MiniportDeviceContext-Parameter von einem Aufruf seiner DxgkDdiAddDevice-Funktion zurückgegeben.

[in] InterruptType

Ein DXGK_INTERRUPT_TYPE-Typwert, der den Interrupttyp bereitstellt.

[in] EnableInterrupt

Ein boolescher Wert, der angibt, ob DxgkDdiControlInterrupt den angegebenen Interrupttyp aktiviert oder deaktiviert. TRUE gibt an, dass es aktiviert ist, und FALSE gibt an, dass es deaktiviert wird.

Rückgabewert

DxgkDdiControlInterrupt gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Interrupttyp wurde auf der Grafikhardware erfolgreich aktiviert oder deaktiviert.
STATUS_NOT_IMPLEMENTED	DxgkDdiControlInterrupt unterstützt das Aktivieren oder Deaktivieren des angegebenen Interrupttyps nicht.

Hinweise

Die DxgkDdiControlInterrupt-Funktion des Anzeigeminiporttreibers kann den angegebenen Interrupttyp aktivieren oder deaktivieren. DxgkDdiControlInterrupt muss den Interrupttyp jedoch nicht deaktivieren, wenn der Treiber den Interrupttyp für einen internen Zweck benötigt. Ein Aufruf von DxgkDdiControlInterrupt zum Aktivieren des angegebenen Interrupttyps gibt an, dass das Betriebssystem erfordert, dass der Treiber die DxgkCbNotifyInterrupt-Funktion aufruft , um zu melden, wann der Interrupttyp auf der Grafikhardware ausgelöst wird.

Derzeit gibt das Microsoft DirectX-Grafikkernsystem nur den DXGK_INTERRUPT_CRTC_VSYNC Interrupttyp im InterruptType-Parameter an. Ein Aufruf von DxgkDdiControlInterrupt zum Aktivieren des DXGK_INTERRUPT_CRTC_VSYNC Interrupttyps gibt an, dass der Treiber den vertikalen Retrace-Interrupt steuert. Während jeder vertikalen Rückverfolgungsphase und unmittelbar nachdem die im DAC-Register angegebene primäre Oberflächenadresse verriegelt und gescannt wurde, sollte der Interrupt ausgelöst und gemeldet werden.

Der Treiber muss STATUS_NOT_IMPLEMENTED zurückgeben, wenn ein anderer Interrupttyp als DXGK_INTERRUPT_CRTC_VSYNC angegeben wird.

DxgkDdiControlInterrupt sollte als ausgelagert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Weitere Informationen

DXGK_INTERRUPT_TYPE

DxgkCbNotifyInterrupt

DxgkDdiAddDevice