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

Метод 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 в случае успешного выполнения; в противном случае возвращает код ошибки.

Комментарии

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

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

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	ksproxy.h (включая Ksproxy.h)

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

KSPIN_INTERFACE

KSPIN_MEDIUM

KSPROPERTY_PIN_DATAFLOW