DXGKDDI_CLOSEALLOCATION callback function (d3dkmddi.h)

The DxgkDdiCloseAllocation function unbinds device-specific allocations that the DxgkDdiOpenAllocation function created.

Syntax

DXGKDDI_CLOSEALLOCATION DxgkddiCloseallocation;

NTSTATUS DxgkddiCloseallocation(
  [in] IN_CONST_HANDLE hDevice,
  [in] IN_CONST_PDXGKARG_CLOSEALLOCATION pCloseAllocation
)
{...}

Parameters

[in] hDevice

A handle to the graphics context device that allocations are unbound from. 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.

[in] pCloseAllocation

A pointer to a DXGKARG_CLOSEALLOCATION structure that contains information about unbinding allocations.

Return value

DxgkDdiCloseAllocation returns STATUS_SUCCESS, or an appropriate error result if the allocations are not successfully unbound from the graphics context device.

Remarks

Before the display miniport driver receives a call to its DxgkDdiDestroyAllocation function to release allocations, the driver calls the DxgkDdiCloseAllocation function to close all bindings to those allocations.

For a resource that contains multiple allocations, the DirectX graphics kernel subsystem directs DxgkDdiCloseAllocation to simultaneously close all of the allocations by specifying the handles to the device-specific allocations in the pOpenHandleList member of the DXGKARG_CLOSEALLOCATION structure.

DxgkDdiCloseAllocation should be made pageable.

Requirements

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

See also

DXGKARG_CLOSEALLOCATION

DXGKARG_CREATEDEVICE

DxgkDdiCreateDevice

DxgkDdiDestroyAllocation

DxgkDdiOpenAllocation