Expand Minimize

DxgkDdiControlInterrupt routine

The DxgkDdiControlInterrupt function enables or disables the given interrupt type on the graphics hardware.

Syntax


PDXGKDDI_CONTROLINTERRUPT DxgkDdiControlInterrupt;

NTSTATUS APIENTRY* DxgkDdiControlInterrupt(
  _In_  const HANDLE hAdapter,
  _In_  const DXGK_INTERRUPT_TYPE InterruptType,
  _In_  BOOLEAN Enable
)
{ ... }

Parameters

hAdapter [in]

[in] A handle to the adapter object for the graphics processing unit (GPU). The driver returned this handle in the MiniportDeviceContext parameter from a call to its DxgkDdiAddDevice function.

InterruptType [in]

[in] A DXGK_INTERRUPT_TYPE-type value that supplies the interrupt type.

Enable [in]

[in] A Boolean value that indicates whether DxgkDdiControlInterrupt enables or disables the specified interrupt type. TRUE indicates that it enables and FALSE indicates that it disables.

Return value

DxgkDdiControlInterrupt returns one of the following values:

Return codeDescription
STATUS_SUCCESS

The interrupt type was successfully enabled or disabled on the graphics hardware.

STATUS_NOT_IMPLEMENTED

DxgkDdiControlInterrupt does not support enabling or disabling the specified interrupt type.

 

Remarks

The display miniport driver's DxgkDdiControlInterrupt function can enable or disable the specified interrupt type. However, DxgkDdiControlInterrupt is not required to disable the interrupt type if the driver requires the interrupt type for an internal purpose. A call to DxgkDdiControlInterrupt to enable the specified interrupt type indicates that the operating system requires that the driver call the DxgkCbNotifyInterrupt function to report when the interrupt type is triggered on the graphics hardware.

Currently, the Microsoft DirectX graphics kernel subsystem specifies only the DXGK_INTERRUPT_CRTC_VSYNC interrupt type in the InterruptType parameter. A call to DxgkDdiControlInterrupt to enable the DXGK_INTERRUPT_CRTC_VSYNC interrupt type indicates for the driver to control vertical retrace interrupt. During every vertical retrace period and immediately after the primary surface address specified in the DAC register is latched and scanned out, the interrupt should be triggered and reported.

The driver must return STATUS_NOT_IMPLEMENTED if an interrupt type other than DXGK_INTERRUPT_CRTC_VSYNC is supplied.

DxgkDdiControlInterrupt should be made pageable.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

PASSIVE_LEVEL

See also

DxgkCbNotifyInterrupt
DxgkDdiAddDevice
DXGK_INTERRUPT_TYPE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft