DXGKCB_UNPINFRAMEBUFFERFORSAVE callback function (d3dkmddi.h)

Article
02/22/2024

A kernel-mode display miniport driver calls DXGKCB_UNPINFRAMEBUFFERFORSAVE to release the mapping that was set in a prior call to DXGKCB_PINFRAMEBUFFERFORSAVE2 or DXGKCB_PINFRAMEBUFFERFORSAVE.

Syntax

DXGKCB_UNPINFRAMEBUFFERFORSAVE DxgkcbUnpinframebufferforsave;

NTSTATUS DxgkcbUnpinframebufferforsave(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARGCB_UNPINFRAMEBUFFERFORSAVE pUnpinFrameBufferForSave
)
{...}

Parameters

[in] hAdapter

A handle to a display adapter. The driver provides this handle for the master/lead device in the LDA chain.

[in] pUnpinFrameBufferForSave

A pointer to the DXGKARGCB_UNPINFRAMEBUFFERFORSAVE structure that contains a handle to the memory to be unmapped.

Return value

DXGKCB_UNPINFRAMEBUFFERFORSAVE returns STATUS_SUCCESS if the operation succeeds. Otherwise, it returns one of the error codes defined in Ntstatus.h.

Remarks

DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, set the members of DXGKARGCB_UNPINFRAMEBUFFERFORSAVE and then call DxgkCbUnpinFrameBufferForSave via the DXGKRNL_INTERFACE.

See IOMMU-based GPU isolation for more information.

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1803 (WDDM 2.4)
Header	d3dkmddi.h
IRQL	PASSIVE_LEVEL