Export (0) Print
Expand All
Expand Minimize

DxgkDdiCloseAllocation routine

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

Syntax


PDXGKDDI_CLOSEALLOCATION DxgkDdiCloseAllocation;

NTSTATUS APIENTRY DxgkDdiCloseAllocation(
  _In_  const HANDLE hDevice,
  _In_  const DXGKARG_CLOSEALLOCATION *pCloseAllocation
)
{ ... }

Parameters

hDevice [in]

[in] 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.

pCloseAllocation [in]

[in] 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

Version

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

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

PASSIVE_LEVEL

See also

DXGKARG_CLOSEALLOCATION
DXGKARG_CREATEDEVICE
DxgkDdiCreateDevice
DxgkDdiDestroyAllocation
DxgkDdiOpenAllocation

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft