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 |