IVMDisplay::_GenerateThumbnail メソッド
[Windows Virtual PC は、Windows 8の時点で使用できなくなりました。 代わりに、 Hyper-V WMI プロバイダー (V2) を使用します。
仮想マシンの画面のサムネイル画像を表すピクセルの配列を取得します。
構文
HRESULT _GenerateThumbnail(
[out] unsigned long thumbnailImage[3072]
);
パラメーター
-
thumbnailImage [out]
-
仮想マシンの画面のサムネイル画像を表すピクセルの配列。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード/値 | 説明 |
|---|---|
|
操作に成功しました。 |
|
パラメーターが NULL です。 |
|
予期しないエラーが発生しました。 |
解説
このインターフェイスは、Thumbnail プロパティよりも効率的に サムネイル を返しますが、スクリプト クライアントからは使用できません。 サムネイルの幅は常に 64 ピクセル、高さは 48 ピクセルです。 各ピクセルは 32 ビットで、上位 8 ビットはピクセルの青い値を表し、次の 8 ビットはピクセルの緑の値を表し、次の 8 ビットはピクセルの赤い値を表します。 配列内の最初の 64 個の要素がサムネイルの最初の行、次の 64 個の要素が 2 行目などです。 このメソッドはピクセルの静的配列を返します。これは、VARIANT 値の SAFEARRAY を返すよりも効率的ですが、スクリプト クライアントと互換性がありません。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| クライアント サポートの終了 |
Windows 7 |
| 製品 |
Windows Virtual PC |
| Header |
|
| IID |
IID_IVMDisplayは 960895e9-f743-4498-96aa-261f867e7fc5 として定義されています |