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_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