DisplayConfigSetDeviceInfo 関数 (winuser.h)

  • [アーティクル]

DisplayConfigSetDeviceInfo 関数は、ターゲットのプロパティを設定します。

構文

LONG DisplayConfigSetDeviceInfo(
  [in] DISPLAYCONFIG_DEVICE_INFO_HEADER *setPacket
);

パラメーター

[in] setPacket

デバイスに設定する情報を含む DISPLAYCONFIG_DEVICE_INFO_HEADER 構造体へのポインター。 DisplayConfigSetDeviceInfo が構成に使用する追加データの種類とサイズは、ヘッダー構造の後に表示されます。 この追加データは、DISPLAYCONFIG_DEVICE_INFO_HEADERの type メンバーで指定されているパケットの 種類 によって異なります。 たとえば、呼び出し元がブート永続化を変更する場合、その呼び出し元は DISPLAYCONFIG_SET_TARGET_PERSISTENCE 構造体を割り当てて入力し、 setPacket 内のこの構造体へのポインターを渡します。 DISPLAYCONFIG_SET_TARGET_PERSISTENCE構造体の最初のメンバーはDISPLAYCONFIG_DEVICE_INFO_HEADERであることに注意してください。

戻り値

関数は、次のいずれかのリターン コードを返します。

リターン コード 説明
ERROR_SUCCESS
 関数が正常に実行されました。
ERROR_INVALID_PARAMETER
 指定されたパラメーターとフラグの組み合わせが無効です。
ERROR_NOT_SUPPORTED
 システムでは、 Windows ディスプレイ ドライバー モデル (WDDM) に従って記述されたグラフィックス ドライバーが実行されていません。 関数は、WDDM ドライバーが実行されているシステムでのみサポートされます。
ERROR_ACCESS_DENIED
 呼び出し元はコンソール セッションにアクセスできません。 このエラーは、呼び出し元のプロセスが現在のデスクトップにアクセスできない場合、またはリモート セッションで実行されている場合に発生します。
ERROR_INSUFFICIENT_BUFFER
 呼び出し元が渡すパケットのサイズが十分な大きさではありません。
ERROR_GEN_FAILURE
 未指定のエラーが発生しました。

解説

DisplayConfigSetDeviceInfo は、現在、アナログ ターゲットでのブート永続化されたフォース プロジェクションの開始と停止にのみ使用できます。 ブート永続化の詳細については、「 強制されたターゲットと接続されたターゲット」を参照してください。

DisplayConfigSetDeviceInfo は、情報の種類DISPLAYCONFIG_DEVICE_INFO_SET_XXX設定する場合にのみ使用できます。 DISPLAYCONFIG_DEVICE_INFO_HEADERの型メンバーがDISPLAYCONFIG_DEVICE_INFO_GET_XXX値のいずれかに設定されている場合、DisplayConfigSetDeviceInfo は失敗します。

要件

要件 値
サポートされている最小のクライアント Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム ユニバーサル
Header winuser.h (Windows.h を含む)
Library User32.lib;Windows 10の OneCoreUAP.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-sysparams-ext-l1-1-1 (Windows 10 バージョン 10.0.14393 で導入)

こちらもご覧ください

DISPLAYCONFIG_DEVICE_INFO_HEADER

DisplayConfigGetDeviceInfo