D3DKMTGetDisplayModeList 関数 (d3dkmthk.h)

D3DKMTGetDisplayModeList 関数は、拡張形式のモードを含む、使用可能な表示モードの一覧を取得します。

構文

NTSTATUS D3DKMTGetDisplayModeList(
  D3DKMT_GETDISPLAYMODELIST *unnamedParam1
);

パラメーター

unnamedParam1

[入力/出力] pData は、この関数の引数を含む D3DKMT_GETDISPLAYMODELIST 構造体へのポインターです。

戻り値

D3DKMTGetDisplayModeList は、次のような NTSTATUS 値を返します。

リターン コード	説明
STATUS_SUCCESS	pData-pModeList が NULL で、pData-ModeCount が入力時にゼロの 場合、使用可能な表示モードの一覧が正常に取得されたか、pData-ModeCount で表示モードの数が返されました。
STATUS_DEVICE_REMOVED	グラフィックス アダプターが停止しました。
STATUS_BUFFER_TOO_SMALL	クライアント ドライバーが pData-pModeList 指定したバッファーは、要求された表示モードの一覧を格納するのに十分な大きさではありません。
STATUS_GRAPHICS_NO_AVAILABLE_VIDPN_TARGET	pData->VidPnSourceId によって識別されるビデオ存在ソースで使用できるビデオ存在ターゲットはありません。 そのため、このソースでは表示モードを使用できません。
STATUS_INVALID_PARAMETER**	パラメーターが検証され、正しくないと判断されました。

備考

グラフィックス アダプター (pData-hAdapter) 上の指定された VidPn ソース (pData-VidPnSourceId) の表示モードの数を取得するには、クライアント ドライバーを使用できます。 pData-pModeList NULL に設定され、pData-ModeCount を 0 として して、D3DKMTGetDisplayModeList 呼び出します。 この呼び出しでSTATUS_SUCCESSが返された場合、返される pData-ModeCount は、表示モードの合計数です。 クライアント ドライバーは、ModeCountD3DKMT_DISPLAYMODE 構造体の配列を割り当て、この配列を指す pModeList 設定し、D3DKMTGetDisplayModeList を再度呼び出して表示モードの一覧を取得できます。

指定した VidPn ソースの表示属性は、これら 2 つの呼び出しの間で変更でき、表示モードの一覧が変更されます。 この場合、呼び出し元が指定した D3DKMT_DISPLAYMODE 配列が新しい表示モードの一覧を保持するのに十分な大きさでない場合、この関数は、返された ModeCountの新しい表示モードの数と共にSTATUS_BUFFER_TOO_SMALLを返します。 呼び出し元は、前の D3DKMT_DISPLAYMODE 配列を解放し、新しい戻り値に基づいて新しい D3DKMT_DISPLAYMODE 配列を割り当て、新しい番号と新しい D3DKMT_DISPLAYMODE 配列を使用してこの関数を再度呼び出して、新しい表示モードの一覧を取得できます。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
ターゲット プラットフォーム の	万国
ヘッダー	d3dkmthk.h (D3dkmthk.h を含む)
ライブラリ	Gdi32.lib
DLL	Gdi32.dll

関連項目

D3DKMT_DISPLAYMODE

D3DKMT_GETDISPLAYMODELIST