Метод IPortableDeviceCapabilities::GetFunctionalCategories (portabledeviceapi.h)

Метод GetFunctionalCategories извлекает все функциональные категории, поддерживаемые устройством.

Синтаксис

HRESULT GetFunctionalCategories(
  [out] IPortableDevicePropVariantCollection **ppCategories
);

Параметры

[out] ppCategories

Адрес переменной, получающей указатель на интерфейс IPortableDevicePropVariantCollection , содержащий все функциональные категории для этого устройства. Значениями будут guids типа VT_CLSID в полученных значениях PROPVARIANT . Вызывающий объект должен освободить этот интерфейс после завершения работы с ним.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.

Комментарии

Функциональные категории описывают типы функций, которые может выполнять устройство, такие как захват изображений, захват звука и хранение. Этот метод обычно выполняется очень быстро, так как драйвер обычно запрашивает устройство только при запуске и кэширует результаты.

Примеры

Пример использования этого метода см. в разделе Извлечение функциональных категорий, поддерживаемых устройством.

Требования

Требование	Значение
Целевая платформа	Windows
Header	portabledeviceapi.h
Библиотека	PortableDeviceGUIDs.lib

См. также раздел

Интерфейс IPortableDeviceCapabilities

Получение функциональных категорий, поддерживаемых устройством