iddCxSwapChainInSystemMemory 函数 (iddcx.h)
IddCxSwapChainInSystemMemory 检查交换链的缓冲区是否驻留在系统内存中。
语法
HRESULT IddCxSwapChainInSystemMemory(
[in] IDDCX_SWAPCHAIN SwapChainObject,
[out] BOOL *pInSystemMemory
);
参数
[in] SwapChainObject
要检查其分配 的IDDCX_SWAPCHAIN 对象。
[out] pInSystemMemory
检查的结果。 如果缓冲区驻留在系统内存中,则设置为 TRUE;否则设置为 FALSE。
返回值
IddCxSwapChainInSystemMemory 在成功时返回S_OK;否则会返回相应的错误代码。 可能的错误包括 SwapChainObject 是无效的交换链对象和 pInSystemMemory 是空指针。
注解
如果交换链的缓冲区驻留在系统内存中,驱动程序可以在调用 IddCxSwapChainSetDevice 以检查之后随时调用 IddCxSwapChainInSystemMemory。 建议驱动程序在分配新的交换链时调用此方法,但在交换链对象生命周期中的任何时间点可以随意调用此方法。
当 IddCxSwapChainInSystemMemory 在 pInSystemMemory 中返回 TRUE 时,驱动程序可以使用 IddCxSwapChainReleaseAndAcquireBuffer 或 IddCxSwapChainReleaseAndAcquireSystemBuffer 从交换链释放和获取缓冲区。 驱动程序必须在该特定交换链的整个生存期内继续使用该特定方法。
当 IddCxSwapChainInSystemMemory 返回 FALSE 时,驱动程序必须使用 IddCxSwapChainReleaseAndAcquireBuffer 从交换链释放和获取缓冲区。
要求
要求 | 值 |
---|---|
最低受支持的服务器 | Windows Server 2022 |
标头 | iddcx.h |