Share via

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 是 Null 指標。

備註

驅動程式可以在呼叫 IddCxSwapChainSetDevice 之後的任何時間點呼叫 IddCxSwapChainInSystemMemory，以檢查交換鏈的緩衝區是否位於系統記憶體中。 建議驅動程式在指派新的交換鏈時呼叫此方法，但可在交換鏈物件的生命週期中的任何時間點呼叫此方法。

當 IddCxSwapChainInSystemMemory 在 pInSystemMemory 中傳回 TRUE 時，驅動程式可以使用 IddCxSwapChainReleaseAndAcquireBuffer 或 IddCxSwapChainReleaseAndAcquireSystemBuffer 來釋放和取得交換鏈中的緩衝區。 驅動程式必須在該特定交換鏈的存留期內繼續使用該特定方法。

當 IddCxSwapChainInSystemMemory 傳回 FALSE 時，驅動程式必須使用 IddCxSwapChainReleaseAndAcquireBuffer 來釋放和取得交換鏈的緩衝區。

規格需求

需求 值
最低支援的伺服器 Windows Server 2022
標頭 iddcx.h

另請參閱

IddCxSwapChainReleaseAndAcquireBuffer

IddCxSwapChainReleaseAndAcquireSystemBuffer