IVMDisplay::SetDimensions メソッド
[Windows Virtual PC は、Windows 8の時点で使用できなくなりました。 代わりに、 Hyper-V WMI プロバイダー (V2) を使用します。
仮想マシン (VM) の表示の高さと幅をピクセル単位で設定します。
構文
HRESULT SetDimensions(
[in] long displayPixelWidth,
[in] long displayPixelHeight
);
パラメーター
-
displayPixelWidth [in]
-
幅 (ピクセル単位)。 値は 640 から 2048 の間である必要があります。 値が 8 で均等に割り切れない場合は、8 の次の下位倍数に縮小されます。
-
displayPixelHeight [in]
-
高さ (ピクセル単位)。 値は、480 から 1920 の間である必要があります。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード/値 | 説明 |
|---|---|
|
操作に成功しました。 |
|
displayPixelWidth パラメーターは、8 で均等に割り切れないか、displayPixelWidth または displayPixelHeight パラメーターが、許容される最小値 (640x480) または最大 2048x1920) の値の範囲外です。 |
|
解決の変更がタイムリーに完了しませんでした。 |
|
この操作では、仮想マシンが実行されている必要があります。 |
|
仮想マシンが無効であるか、現在実行中ではありません。 |
|
VM の有効な表示が見つからない。 |
|
ゲスト オペレーティング システムにインストールされている統合コンポーネントのバージョンでは、この操作はサポートされていません。 |
|
予期しないエラーが発生しました。 |
解説
仮想マシンのディスプレイの最小サイズは 640 x 480 ピクセルです。 最大サイズは 2048 x 1920 です。 表示サイズをこれらの制限外の値、または 8 で均等に割り切れない幅に設定しようとすると、 E_INVALIDARG エラーが返されます。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| クライアント サポートの終了 |
Windows 7 |
| 製品 |
Windows Virtual PC |
| Header |
|
| IID |
IID_IVMDisplayは 960895e9-f743-4498-96aa-261f867e7fc5 として定義されています |