Edit

DXGKDDI_DESTROYDEVICE callback function (d3dkmddi.h)

  • Article

The DxgkDdiDestroyDevice function destroys a graphics context device.

Syntax

DXGKDDI_DESTROYDEVICE DxgkddiDestroydevice;

NTSTATUS DxgkddiDestroydevice(
  [in] IN_CONST_HANDLE hDevice
)
{...}

Parameters

[in] hDevice

A handle to the graphics context device that DxgkDdiDestroyDevice will destroy. The display miniport driver's DxgkDdiCreateDevice function previously provided this handle to the Microsoft DirectX graphics kernel subsystem in the hDevice member of the DXGKARG_CREATEDEVICE structure.

Return value

DxgkDdiDestroyDevice returns STATUS_SUCCESS, or an appropriate error result if the graphics context device is not successfully destroyed.

Remarks

The DirectX graphics kernel subsystem calls the display miniport driver's DxgkDdiDestroyDevice function to destroy a graphics context device that the driver's DxgkDdiCreateDevice function created. DxgkDdiDestroyDevice should free all of the resources that were allocated for the device and clean up any internal tracking data structures.

DxgkDdiDestroyDevice should be made pageable.

Requirements

Requirement Value
Minimum supported client Windows Vista
Target Platform Desktop
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

See also

DXGKARG_CREATEDEVICE

DxgkDdiCreateDevice