Поделиться через


Метод 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
Указатель pTypeNULL.

Замечания

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

  • Если тип связи KS 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 [только классические приложения]
целевая платформа Виндоус
заголовка devicetopology.h

См. также

интерфейса IConnector