GetDisplayConfigBufferSizes 関数 (winuser.h)

[アーティクル]
08/27/2023

GetDisplayConfigBufferSizes 関数は、QueryDisplayConfig 関数を呼び出すために必要なバッファーのサイズを取得します。

構文

LONG GetDisplayConfigBufferSizes(
  [in]  UINT32 flags,
  [out] UINT32 *numPathArrayElements,
  [out] UINT32 *numModeInfoArrayElements
);

パラメーター

[in] flags

取得する情報の種類。 Flags パラメーターの値は、次のいずれかの値である必要があります。

QDC_ALL_PATHS

呼び出し元は、考えられるすべてのパスの組み合わせを保持するようにテーブルサイズを要求します。

QDC_ONLY_ACTIVE_PATHS

呼び出し元は、アクティブなパスのみを保持するようにテーブルサイズを要求します。

QDC_DATABASE_CURRENT

呼び出し元は、現在接続されているモニターの永続化データベースで定義されているアクティブパスを保持するようにテーブルサイズを要求します。

[out] numPathArrayElements

パス情報テーブル内の要素の数を受け取る変数へのポインター。 pNumPathArrayElements パラメーター値は、QueryDisplayConfig 関数の後続の呼び出しによって使用されます。このパラメーターを NULL にすることはできません。

[out] numModeInfoArrayElements

モード情報テーブル内の要素の数を受け取る変数へのポインター。 pNumModeInfoArrayElements パラメーター値は、QueryDisplayConfig 関数の後続の呼び出しによって使用されます。このパラメーターを NULL にすることはできません。

戻り値

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

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

解説

現在の表示パス構成と要求されたフラグを指定すると、 GetDisplayConfigBufferSizes は、情報を格納するために必要なパステーブルとモードテーブルのサイズを返します。 GetDisplayConfigBufferSizes は、すべてのソースパスとターゲットパスが有効であると判断されるため、実際に必要な値よりも少し大きい値を返すことができます。一方、ドライバーでは、考えられる組み合わせにいくつかの制限が適用される場合があります。

GetDisplayConfigBufferSizes は、その時点の必要な配列サイズのみを決定できるため、GetDisplayConfigBufferSizes と QueryDisplayConfig の呼び出しの間にシステム構成が変更され、指定された配列サイズが新しいパスデータを格納するのに十分ではなくなった可能性があります。

呼び出し元が追加のソースとターゲットを有効にする必要があることを認識している場合、呼び出し元は GetDisplayConfigBufferSizes から返されるよりも大きなモード情報配列を割り当てて、 QueryDisplayConfig を呼び出した後、および SetDisplayConfig を呼び出す前に追加のソースモードとターゲットモードを追加する領域を確保できます。

例

GetDisplayConfigBufferSizes の例については、「QueryDisplayConfig」を参照してください。

要件

要件	値
サポートされている最小のクライアント	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 で導入)

こちらもご覧ください

QueryDisplayConfig

SetDisplayConfig

次の方法で共有