Метод 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) |