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 (GPU). Der Treiber hat dieses Handle im MiniportDeviceContext Parameter von einem Aufruf an die DxgkDdiAddDevice--Funktion zurückgegeben.
[in] InterruptType
Ein DXGK_INTERRUPT_TYPE-Type-Wert, 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 und FALSE angibt, dass er 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. |
Bemerkungen
Die dxgkDdiControlInterrupt-Funktion des Anzeigeminiporttreibers kann den angegebenen Interrupttyp aktivieren oder deaktivieren. DxgkDdiControlInterrupt- ist jedoch nicht erforderlich, um den Interrupttyp zu deaktivieren, wenn der Treiber den Interrupttyp für einen internen Zweck benötigt. Ein Aufruf von DxgkDdiControlInterrupt, um den angegebenen Interrupttyp zu aktivieren, gibt an, dass der Treiber die DxgkCbNotifyInterrupt-funktion aufruft, um zu melden, wann der Interrupttyp auf der Grafikhardware ausgelöst wird.
Derzeit gibt das Microsoft DirectX-Grafik-Kernelsubsystem nur den DXGK_INTERRUPT_CRTC_VSYNC Interrupttyp im parameter InterruptType an. Ein Aufruf von DxgkDdiControlInterrupt-, um den DXGK_INTERRUPT_CRTC_VSYNC Interrupttyp zu aktivieren, gibt an, dass der Treiber den vertikalen Retrace-Interrupt steuert. Während jedes vertikalen Retrace-Zeitraums und unmittelbar nach der primären Oberflächenadresse, die im DAC-Register angegeben ist, verriegelt und gescannt wird, 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 bereitgestellt wird.
DxgkDdiControlInterrupt sollte seitenfähig gemacht werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h |
| IRQL- | PASSIVE_LEVEL |