IStillImageW::GetDeviceList 메서드(sti.h)
IStillImage::GetDeviceList 메서드는 설치된 모든 스틸 이미지 디바이스에 대한 하드웨어 특성을 반환합니다.
구문
HRESULT GetDeviceList(
DWORD dwType,
DWORD dwFlags,
[out] DWORD *pdwItemsReturned,
[out] LPVOID *ppBuffer
);
매개 변수
dwType
예약된 매개 변수, NULL을 사용합니다.
dwFlags
예약된 매개 변수, NULL을 사용합니다.
[out] pdwItemsReturned
ppBuffer에서 참조하는 버퍼에 제공된 STI_DEVICE_INFORMATION 구조체의 수를 받습니다.
[out] ppBuffer
STI 할당 버퍼에 대한 핸들을 받습니다. 이 버퍼에는 STI_DEVICE_INFORMATION 구조체의 배열이 포함됩니다.
반환 값
작업이 성공하면 메서드는 S_OK 반환합니다. 그렇지 않으면 stierr.h에 정의된 STIERR 접두사 오류 코드 중 하나를 반환합니다.
설명
IStillImage::GetDeviceList 메서드는 설치된 각 스틸 이미지 디바이스에 대한 STI_DEVICE_INFORMATION 구조를 반환합니다. 구조체 콘텐츠는 일반적으로 사용자 인터페이스 디스플레이를 만들고 디바이스의 내부 이름을 찾는 데 사용됩니다.
IStillImage::GetDeviceList를 호출하기 전에 IStillImage COM 인터페이스의 클라이언트는 IStillImage::StiCreateInstance를 호출하여 IStillImage 인터페이스 포인터를 가져와야 합니다.
호출자가 ppBuffer에서 참조하는 STI_DEVICE_INFORMATION 구조의 배열 사용을 완료한 경우 LocalFree(Microsoft Windows SDK 설명서에 설명됨)를 호출하여 배열의 할당을 취소해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | sti.h(Sti.h 포함) |