IddCxSwapChainReleaseAndAcquireBuffer2 函式 (iddcx.h)
間接顯示驅動程式會呼叫 IddCxSwapChainReleaseAndAcquireBuffer2 ,以釋放交換鏈結中的目前緩衝區,並取得新的緩衝區。 支援 HDR 配接器的驅動程序必須使用 IddCxSwapChainReleaseAndAcquireBuffer2 ,而不是 IddCxSwapChainReleaseAndAcquireBuffer 和 IddCxSwapChainReleaseAndAcquireSystemBuffer。
語法
HRESULT IddCxSwapChainReleaseAndAcquireBuffer2(
IDDCX_SWAPCHAIN SwapChainObject,
IDARG_IN_RELEASEANDACQUIREBUFFER2 *pInArgs,
IDARG_OUT_RELEASEANDACQUIREBUFFER2 *pOutArgs
);
參數
SwapChainObject
[in]操作系統先前在 呼叫EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN 中傳遞至驅動程式的交換鏈結物件。
pInArgs
[in]包含函式輸入自變數 之IDARG_IN_RELEASEANDACQUIREBUFFER2 結構的指標。
pOutArgs
[out]傳回函式輸出自變數 之IDARG_OUT_RELEASEANDACQUIREBUFFER2 結構的指標。
傳回值
IddCxSwapChainReleaseAndAcquireBuffer2 會在成功時傳回S_OK;否則會傳回適當的錯誤碼。
備註
在 IDDCX_METADATA2 結構中傳遞之表面的色彩空間也會傳遞至驅動程式。 這是因為每個畫面可能會變更,且不符合認可模式時所指定的色彩空間。
同樣地,所提供介面的圖元格式可以依畫面格變更。 例如,如果在路徑上認可 HDR 模式,這不保證每個表面都會是 FP16 表面。
SDR 內容的白色層級也包含在內,以套用至滑鼠游標。
如果在 IDDCX_METADATA2::ValidFlags 中設定IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA,則 IDDCX_METADATA2::Hdr10FrameMetaData 包含有效的數據。 此元資料可以是下列三種類型的其中一種:
- 驅動程式應該使用的新數據。
- 指出應該使用先前在呼叫中傳送至驅動程序的預設元數據 EVT_IDD_CX_MONITOR_SET_DEFAULT_HDR_METADATA 。
- 指出先前傳送的任何元數據都應該再次使用。 當類型為預設值或未變更時 ,IDDCX_HDR10_FRAME_METADATA::NewMetaData 中的值無效。
IddCxSwapChainReleaseAndAcquireBuffer2 也會取代 IddCxSwapChainReleaseAndAcquireSystemBuffer。 名為 IddCxSwapChainReleaseAndAcquireSystemBuffer 的驅動程式可以設定 IDARG_IN_RELEASEANDACQUIREBUFFER2::AcquireSystemMemoryBuffer 來指出它需要 IDDCX_METADATA2::SystemBufferInfo 填入。
未報告 FP16 支援的 1.10 版驅動程式,如果 OS 中提供此函式,仍可呼叫此函式。
如需 HDR 支援的詳細資訊,請參閱 IddCx 1.10 版更新。
遠端 HDR 元數據
OS 不會將 HDR 元數據傳遞至遠端驅動程式,因為應該使用客戶端系統上的 HDR 元數據,而不是伺服器所產生的任何。 對於遠端驅動程式 IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA 永遠不會設定。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 11 版本 22H2 9 月更新 (IddCx 1.10 版) |
標頭 | iddcx.h |
另請參閱
IDARG_IN_RELEASEANDACQUIREBUFFER2