структура 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) |