IPortableDeviceCapabilities::GetFunctionalCategories 메서드(portabledeviceapi.h)
GetFunctionalCategories 메서드는 디바이스에서 지원하는 모든 기능 범주를 검색합니다.
구문
HRESULT GetFunctionalCategories(
[out] IPortableDevicePropVariantCollection **ppCategories
);
매개 변수
[out] ppCategories
이 디바이스의 모든 기능 범주를 포함하는 IPortableDevicePropVariantCollection 인터페이스에 대한 포인터를 수신하는 변수의 주소입니다. 값은 검색된 PROPVARIANT 값에 VT_CLSID 형식의 GUID입니다. 호출자는 이 인터페이스가 완료되면 이 인터페이스를 해제해야 합니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 성공했습니다. |
설명
기능 범주는 이미지 캡처, 오디오 캡처 및 스토리지와 같이 디바이스에서 수행할 수 있는 함수 유형을 설명합니다. 드라이버가 일반적으로 시작 시만 디바이스를 쿼리하고 결과를 캐시하기 때문에 이 메서드는 일반적으로 매우 빠릅니다.
예제
이 메서드를 사용하는 방법에 대한 예제는 디바이스에서 지원하는 기능 범주 검색을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | portabledeviceapi.h |
| 라이브러리 | PortableDeviceGUIDs.lib |