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 |