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