Share via

структура KSPIN_CONNECT (ks.h)

  • Статья

Клиенты используют структуру KSPIN_CONNECT для описания подключения, запрашиваемого у драйвера в вызове KsCreatePin .

Синтаксис

typedef struct {
  KSPIN_INTERFACE Interface;
  KSPIN_MEDIUM    Medium;
  ULONG           PinId;
  HANDLE          PinToHandle;
  KSPRIORITY      Priority;
} KSPIN_CONNECT, *PKSPIN_CONNECT;

Члены

Interface

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

Medium

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

PinId

Указывает идентификатор типа пин-кода. Если поле PinToHandle не равно NULL, это поле содержит идентификатор исходного пин-кода, в который отправляется запрос. В противном случае это поле ссылается на контакт приемника, к которому выполняется подключение. Если контакт может поддерживать как источник, так и приемник в обмене данными, то это неявный метод, сообщающий ему, как он должен действовать в соединении.

PinToHandle

Указывает, для какого типа закрепления назначения предназначено создание, а в случае исходного назначения — к какому контакту следует подключиться. Этот элемент имеет значение NULL , когда клиент запрашивает подключение к себе. В противном случае это целевой объект запроса на подключение. В случае исходного назначения он содержит дескриптор экземпляра контакта, к котором необходимо установить соединение. В случае назначения приемника это поле содержит значение NULL и не используется иным образом.

Priority

Структура типа KSPRIORITY , указывающая приоритет соединения, обычно KSPRIORITY_NORMAL. Дополнительные сведения см. в описании свойства KSPROPERTY_CONNECTION_PRIORITY .

Комментарии

Если KSPIN_CONNECT. Элемент PinToHandle не имеет значение NULL, IRP_MJ_CREATE указывает устройству подключить исходный KSPIN_CONNECT. Закрепление PinId на KSPIN_CONNECT. Экземпляр pinToHandle. В противном случае это запрос от клиента на подключение к KSPIN_CONNECT. PinId с помощью KSPIN_CONNECT. Средний метод и определенный формат данных, указанный после структуры соединения. В любом случае драйвер устройства может не выполнить этот запрос, если это подключение не может быть принято.

Требования

Требование Значение
Заголовок ks.h (включая Ks.h)

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

KSPIN_INTERFACE

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin