次の方法で共有

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