структура 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. Закрепление Пин-кода к KSPIN_CONNECT. Экземпляр pinToHandle. В противном случае это запрос от клиента для подключения к KSPIN_CONNECT. PinId pinid с помощью KSPIN_CONNECT. Средний метод и определенный формат данных, указанный после структуры соединения. В любом случае драйвер устройства может завершиться ошибкой, если это подключение не может быть принято.
Требования
| Требование | Ценность |
|---|---|
| заголовка | ks.h (include Ks.h) |