共用方式為


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