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) 链中的main/潜在顾客设备提供此句柄。

[in/out] pPinFrameBufferForSave2

指向 DXGKARGCB_PINFRAMEBUFFERFORSAVE2 结构的指针，该结构包含有关要保存的帧缓冲区的信息。

返回值

如果操作成功，DXGKCB_PINFRAMEBUFFERFORSAVE2将返回STATUS_SUCCESS。 否则， 将返回相应的 NTSTATUS 错误代码。

注解

原始 WDDM 2.4 IOMMU 实现 包含一对回调函数，用于查询保存帧缓冲区所需的内存。 帧缓冲区保存区域在初始化期间创建为节对象，驱动程序在需要时使用这些回调来获取 IOMMU 映射区域。

使用地址描述符列表的驱动程序 (ADL) 支持逻辑 DMA 重新映射实现 DXGKCB_PINFRAMEBUFFERFORSAVE2 而不是 DXGKARGCB_PINFRAMEBUFFERFORSAVE。

可以使用原始DXGKCB_UNPINFRAMEBUFFERFORSAVE回调取消固定使用 DXGKCB_PINFRAMEBUFFERFORSAVE2 固定 的 内存。

有关详细信息 ，请参阅 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