共用方式為


DXGKCB_PINFRAMEBUFFERFORSAVE2回呼函式 (d3dkmddi.h)

核心模式顯示迷你埠驅動程式會呼叫 DXGKCB_PINFRAMEBUFFERFORSAVE2 ,一次釘選整個框架緩衝區。

語法

DXGKCB_PINFRAMEBUFFERFORSAVE2 DxgkcbPinframebufferforsave2;

NTSTATUS DxgkcbPinframebufferforsave2(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_PINFRAMEBUFFERFORSAVE2 pPinFrameBufferForSave2
)
{...}

參數

[in] hAdapter

顯示配接器的句柄。 驅動程式會在連結的顯示配接器 (LDA) 鏈結中,提供主要/潛在客戶裝置的這個句柄。

[in/out] pPinFrameBufferForSave2

包含要儲存之框架緩衝區相關信息 的DXGKARGCB_PINFRAMEBUFFERFORSAVE2 結構的指標。

傳回值

如果 作業成功,DXGKCB_PINFRAMEBUFFERFORSAVE2會傳回STATUS_SUCCESS。 否則,傳回適當的NTSTATUS錯誤碼。

備註

原始 WDDM 2.4 IOMMU 實 作包含一組回呼函式,可查詢儲存框架緩衝區所需的記憶體。 框架緩衝區儲存區域是在初始化期間建立為區段物件,而驅動程式會在需要時使用這些回呼來取得IOMMU對應區域。

使用位址描述符的驅動程式會列出 (ADL) ,以支持邏輯 DMA 重新對應實作 DXGKCB_PINFRAMEBUFFERFORSAVE2 ,而不是 DXGKARGCB_PINFRAMEBUFFERFORSAVE

使用 DXGKCB_PINFRAMEBUFFERFORSAVE2 釘選的記憶體可以使用原始 DXGKCB_UNPINFRAMEBUFFERFORSAVE 回呼取消釘選。

如需詳細資訊 ,請參閱 IOMMU DMA 重新對應

DXGKCB_XXX 函式是由 Dxgkrnl 實作。 若要使用此回呼函式,請設定DXGKARGCB_PINFRAMEBUFFERFORSAVE2的適當成員,然後透過 DXGKRNL_INTERFACE 呼叫 DxgkCbPinFrameBufferForSave2

規格需求

需求
最低支援的伺服器 Windows Server 2022 (WDDM 2.9)
標頭 d3dkmddi.h
IRQL PASSIVE_LEVEL

另請參閱

DXGKARGCB_PINFRAMEBUFFERFORSAVE2

DXGKARGCB_PINFRAMEBUFFERFORSAVE

DXGKCB_UNPINFRAMEBUFFERFORSAVE