IVMDisplay::_GenerateThumbnail 메서드
[Windows 가상 PC는 Windows 8 더 이상 사용할 수 없습니다. 대신 Hyper-V WMI 공급자(V2)를 사용합니다.]
가상 머신 화면의 썸네일 이미지를 나타내는 픽셀 배열을 검색합니다.
구문
HRESULT _GenerateThumbnail(
[out] unsigned long thumbnailImage[3072]
);
매개 변수
-
thumbnailImage [out]
-
가상 머신 화면의 썸네일 이미지를 나타내는 픽셀 배열입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드/값 | Description |
|---|---|
|
작업이 완료되었습니다. |
|
매개 변수가 NULL입니다. |
|
예기치 않은 오류가 발생했습니다. |
설명
이 인터페이스는 Thumbnail 속성보다 썸네일을 더 효율적으로 반환하지만 스크립팅 클라이언트에서는 사용할 수 없습니다. 썸네일은 항상 너비가 64픽셀이고 높이가 48픽셀입니다. 각 픽셀은 32비트입니다. 여기서 상위 8비트에서는 픽셀의 파란색 값을 나타내고, 다음 8비트에서는 픽셀의 녹색 값을 나타내고, 다음 8비트에서는 픽셀의 빨간색 값을 나타냅니다. 배열의 처음 64개 요소는 썸네일의 첫 번째 행이고, 다음 64개 요소는 두 번째 행입니다. 이 메서드는 VARIANT 값의 SAFEARRAY를 반환하는 것보다 더 효율적이지만 스크립팅 클라이언트와 호환되지 않는 픽셀의 정적 배열을 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 클라이언트 지원 종료 |
Windows 7 |
| 제품 |
Windows Virtual PC |
| 헤더 |
|
| IID |
IID_IVMDisplay 960895e9-f743-4498-96aa-261f867e7fc5로 정의됩니다. |