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 포함)

추가 정보

IStillImage::GetDeviceInfo

IStillImageW