次の方法で共有

D3DKMTSetDisplayMode 関数 (d3dkmthk.h)

  • [アーティクル]

D3DKMTSetDisplayMode 関数は、ディスプレイへのスキャンアウトに使用される割り当てを設定します。

構文

NTSTATUS D3DKMTSetDisplayMode(
  [in, out] const D3DKMT_SETDISPLAYMODE *unnamedParam1
);

パラメーター

[in, out] unnamedParam1

スキャンアウトに使用される割り当てを記述する D3DKMT_SETDISPLAYMODE 構造体へのポインター。

戻り値

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

リターン コード 形容
STATUS_SUCCESS 表示モードが正常に設定されました。
STATUS_DEVICE_REMOVED グラフィックス アダプターが停止したか、ディスプレイ デバイスがリセットされました。
STATUS_INVALID_PARAMETER パラメーターが検証され、正しくないと判断されました。
STATUS_GRAPHICS_NOT_EXCLUSIVE_MODE_OWNER D3DKMTSetDisplayMode 呼び出す前に、デバイスはビューの排他的所有権を取得しませんでした。 そのため、デバイスは表示モードを設定できませんでした。
D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT OpenGL インストール可能クライアント ドライバー (ICD) は、D3DKMT_SETDISPLAYMODE の hPrimaryAllocation メンバーが指定 割り当てに関連付けられているサーフェスの形式を、D3DKMT_SETDISPLAYMODE の PrivateDriverFormatAttribute メンバーが指定する形式属性に変換する必要があります。 その後、ICD は D3DKMTSetDisplayMode を再度呼び出す必要があります。 ICD は、新しい割り当てを割り当て、古いプライマリから新しいプライマリへのビット ブロック転送 (bitblt) の変換を実行し、ICD が後続のすべての操作でこの割り当てに新しい割り当てハンドルを使用している限り、古いプライマリを破棄できます。 D3DKMTSetDisplayMode が別の戻り値を返すまで、ICD はこのプロセスを繰り返す必要があります。

この関数は、NTSTATUS 値 他の値を返す場合もあります。

備考

OpenGL ICD D3DKMTSetDisplayMode を呼び出して拡張形式、マルチ サンプリング メソッド、またはその両方を使用する新しい表示モードを設定する前に、ICD は、現在の GDI 表示モードが新しい表示モードと同じ解像度であることを確認する必要があります。 それ以外の場合、D3DKMTSetDisplayMode は STATUS_INVALID_PARAMETERを返します。

必要条件

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

関連項目

D3DKMT_SETDISPLAYMODE