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