IddCxSwapChainReleaseAndAcquireBuffer2 関数 (iddcx.h)

間接ディスプレイ ドライバーは 、IddCxSwapChainReleaseAndAcquireBuffer2 を呼び出して、スワップ チェーン内の現在のバッファーを解放し、新しいバッファーを取得します。 HDR アダプターをサポートするドライバーでは、IddCxSwapChainReleaseAndAcquireBuffer と IddCxSwapChainReleaseAndAcquireSystemBuffer の代わりに IddCxSwapChainReleaseAndAcquireBuffer2 を使用する必要があります。

構文

HRESULT IddCxSwapChainReleaseAndAcquireBuffer2(
  IDDCX_SWAPCHAIN                    SwapChainObject,
  IDARG_IN_RELEASEANDACQUIREBUFFER2  *pInArgs,
  IDARG_OUT_RELEASEANDACQUIREBUFFER2 *pOutArgs
);

パラメーター

SwapChainObject

[入力] EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN 呼び出しで OS によってドライバーに渡されたスワップ チェーン オブジェクト。

pInArgs

[入力]関数の入力引数を含む 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 に有効なデータが含まれます。 このメタデータには、次の 3 種類のいずれかを指定できます。

• ドライバーで使用する必要がある新しいデータ。
• 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 メタデータ

サーバーによって生成されるのではなく、クライアント システム上の HDR メタデータを使用する必要があるため、OS は HDR メタデータをリモート ドライバーに渡しません。 リモート ドライバー の場合、IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA は設定されません。

要件

こちらもご覧ください

IDARG_IN_RELEASEANDACQUIREBUFFER2

IDARG_OUT_RELEASEANDACQUIREBUFFER2

IDDCX_METADATA2