Метод IKsPin::KsGetCurrentCommunication (ksproxy.h)

Статья
02/07/2025

Метод KsGetCurrentCommunication извлекает текущее направление связи, интерфейс и носитель пин-кода.

Синтаксис

HRESULT KsGetCurrentCommunication(
  [out, optional] KSPIN_COMMUNICATION *Communication,
  [out, optional] KSPIN_INTERFACE     *Interface,
  [out, optional] KSPIN_MEDIUM        *Medium
);

Параметры

[out, optional] Communication

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

Ценность	Описание
KSPIN_COMMUNICATION_NONE	Фабрика контактов не создает экземпляры пин-кода.
KSPIN_COMMUNICATION_SINK	Фабрика закреплений создает экземпляры контактов приемника IRP. Такие закрепления могут быть подключены только к пин-кодам источника IRP.
KSPIN_COMMUNICATION_SOURCE	Фабрика контактов создает экземпляры исходных закреплений IRP. Такие закрепления могут быть подключены только к пин-адресам приемника IRP.
KSPIN_COMMUNICATION_BOTH	Фабрика контактов создает экземпляры контактов, которые являются приемниками IRP и источниками IRP.
KSPIN_COMMUNICATION_BRIDGE	Пин-код не может подключаться к другим пин-кодам, но экземпляры могут быть созданы для получения запросов ввода-вывода, отличных от KS.

[out, optional] Interface

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

[out, optional] Medium

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

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

Возвращает NOERROR в случае успешного выполнения; в противном случае возвращает код ошибки.

Замечания

Исходные закрепления отправляют irPs в пин-коды приемника. Не путайте направление связи с направлением потока данных. (См. KSPROPERTY_PIN_DATAFLOW.) Исходный пин-код может считывать или записывать данные, а пин-код приемника может иметь данные, считыванные в него или записанные из него.

Текущее направление связи, интерфейс и среда пин-кода являются подмножеством доступных для пин-кода и выбираются при создании дескриптора пин-кода.