Метод IConnector::GetType (devicetopology.h)

  • Статья

Метод GetType получает тип этого соединителя.

Синтаксис

HRESULT GetType(
  [out] ConnectorType *pType
);

Параметры

[out] pType

Указатель на переменную, в которую метод записывает тип соединителя. Тип соединителя является одной из следующих констант перечисления ConnectorType :

Unknown_Connector

Physical_Internal

Physical_External

Software_IO

Software_Fixed

Сеть

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

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.

Код возврата Описание
E_POINTER
 Указатель pType имеет значение NULL.

Комментарии

Соединитель соответствует "закреплению" в терминологии потоковой передачи ядра (KS). Сопоставление контактов KS с соединителями выглядит следующим образом:

  • Если тип связи ks pin — KSPIN_COMMUNICATION_SINK, KSPIN_COMMUNICATION_SOURCE или KSPIN_COMMUNICATION_BOTH, то тип соединителя будет Software_IO.
  • В противном случае, если контакт является частью физического соединения между двумя фильтрами KS (устройствами) в одном звуковом адаптере или в разных аудиоадаптерах, тип соединителя будет Software_Fixed.
  • В противном случае, если категория контактов KS — KSNODETYPE_SPEAKER, KSNODETYPE_MICROPHONE, KSNODETYPE_LINE_CONNECTOR или KSNODETYPE_SPDIF_INTERFACE, тип соединителя будет Physical_External.
  • В противном случае для контакта, который не соответствует ни одному из предыдущих критериев, тип соединителя Physical_Internal.
Дополнительные сведения о контактах KS см. в документации по Windows DDK.

Пример кода, который вызывает метод GetType , см. в разделе Реализация функции SelectCaptureDevice в топологиях устройств.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header devicetopology.h

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

Интерфейс IConnector