D3DKMTGetDisplayModeList 関数 (d3dkmthk.h)

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

構文

NTSTATUS D3DKMTGetDisplayModeList(
  D3DKMT_GETDISPLAYMODELIST *unnamedParam1
);

パラメーター

unnamedParam1

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

戻り値

D3DKMTGetDisplayModeList は、次のいずれかの NTSTATUS 値を返します。

リターン コード	説明
STATUS_SUCCESS	pData-pModeList が NULL で、入力時に pData-ModeCount> が 0 の場合、使用可能な表示モードの一覧が正常に取得されたか、表示モードの数が 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
対象プラットフォーム	ユニバーサル
Header	d3dkmthk.h (D3dkmthk.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll

こちらもご覧ください

D3DKMT_DISPLAYMODE

D3DKMT_GETDISPLAYMODELIST