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であることに注意してください。
戻り値
関数は、次のいずれかのリターン コードを返します。
| リターン コード | 説明 |
|---|---|
|
関数が正常に実行されました。 |
|
指定されたパラメーターとフラグの組み合わせが無効です。 |
|
システムでは、 Windows ディスプレイ ドライバー モデル (WDDM) に従って記述されたグラフィックス ドライバーが実行されていません。 関数は、WDDM ドライバーが実行されているシステムでのみサポートされます。 |
|
呼び出し元はコンソール セッションにアクセスできません。 このエラーは、呼び出し元のプロセスが現在のデスクトップにアクセスできない場合、またはリモート セッションで実行されている場合に発生します。 |
|
呼び出し元が渡すパケットのサイズが十分な大きさではありません。 |
|
未指定のエラーが発生しました。 |
解説
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 で導入) |