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 |