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 メンバー が指定する format 属性に変換する必要があります。 その後、ICD は D3DKMTSetDisplayMode を再度呼び出す必要があります。 ICD は、新しい割り当てを割り当て、古いプライマリから新規へのビット ブロック転送 (bitblt) を実行し、ICD が後続のすべての操作にこの割り当てに新しい割り当てハンドルを使用している限り、古いプライマリを破棄できます。 ICD は、 D3DKMTSetDisplayMode が別の戻り値を返すまで、このプロセスを繰り返す必要があります。

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

注釈

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista
対象プラットフォーム	ユニバーサル
Header	d3dkmthk.h (D3dkmthk.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll

こちらもご覧ください

D3DKMT_SETDISPLAYMODE