Share via

IddCxAdapterDisplayConfigUpdate 関数 (iddcx.h)

  • [アーティクル]

リモート ドライバーは 、IddCxAdapterDisplayConfigUpdate を呼び出して、クライアントがサーバーにモニター構成の更新方法を指示できるようにします。 HDR サポートを報告するドライバーでは、代わりに IddCxAdapterDisplayConfigUpdate2 を使用する必要があります。

構文

NTSTATUS IddCxAdapterDisplayConfigUpdate(
  IDDCX_ADAPTER                             AdapterObject,
  const IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE *pInArgs
);

パラメーター

AdapterObject

[入力]表示構成が指定されているリモート アダプターの IDDCX_ADAPTER オブジェクト。

pInArgs

[入力]関数への入力引数を含む IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE 構造体へのポインター。

戻り値

IddCxAdapterDisplayConfigUpdate は 、成功時にSTATUS_SUCCESSを返します。それ以外の場合は、適切なエラー コードを返します。 「解説」を参照してください。

Remarks

リモート間接ディスプレイ ドライバー (IDD) は、新しい表示構成を受信したときに IddCxAdapterDisplayConfigUpdate を呼び出します。

OS は、新しく指定された表示構成を格納している場合は、STATUS_SUCCESSを返します。 これらの変更により、要求に応じてモニターのスワップチェーンが非同期的に再構成されます。 IddCxAdapterDisplayConfigUpdate は、最初に保留中のモニターの到着をフラッシュし、モニターの一覧が最新であることを確認するために出発を処理します。

IddCxAdapterDisplayConfigUpdate は、指定された表示構成がドライバーで現在サポートされていないと判断した場合は、STATUS_INVALID_PARAMETERを返し、デバッグ目的で WPP を使用して理由をログに記録します。 たとえば、ドライバーが指定した解像度/更新レートをサポートしていない場合や、無効なモニターが指定されている可能性があります。

IddCxAdapterDisplayConfigUpdate は、この構成変更の対象となるセッションが切断された場合、またはセッション アダプターが停止している場合に、STATUS_GRAPHICS_INDIRECT_DISPLAY_DEVICE_STOPPEDを返します。

要件

要件 値
サポートされている最小のクライアント Windows 10 バージョン 1903
Header iddcx.h

こちらもご覧ください

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE

IddCxAdapterDisplayConfigUpdate2