estrutura KSPIN_CONNECT (ks.h)

Os clientes usam a estrutura KSPIN_CONNECT para descrever a conexão que solicitam de um driver em uma chamada KsCreatePin .

Sintaxe

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

Membros

Interface

Especifica o KSPIN_INTERFACE a ser usado para essa conexão.

Medium

Uma estrutura do tipo KSPIN_MEDIUM que especifica o meio a ser usado para essa conexão.

PinId

Especifica o número da ID do tipo de pino. Se o campo PinToHandle não for NULL, esse campo conterá o identificador do pino de origem para o qual a solicitação está sendo enviada. Caso contrário, esse campo se refere ao pino do coletor ao qual está sendo conectado. Se um pin puder dar suporte a ser uma origem e um coletor nas comunicações, esse será o método implícito de informá-lo como ele deve agir na conexão.

PinToHandle

Especifica a que tipo de pino de destino a criação se destina e, no caso de um destino de origem, a qual pino se conectar. Esse membro é NULL quando um cliente solicita uma conexão a si mesmo. Caso contrário, ele será o destino da solicitação de conexão. No caso de um destino de origem, ele contém o identificador da instância de pino para estabelecer uma conexão. No caso de um destino de coletor, esse campo contém NULL e não é usado de outra forma.

Priority

Uma estrutura do tipo KSPRIORITY que especifica a prioridade para a conexão, geralmente KSPRIORITY_NORMAL. Consulte a propriedade KSPROPERTY_CONNECTION_PRIORITY para obter detalhes.

Comentários

Se o KSPIN_CONNECT. O elemento PinToHandle não é NULL, IRP_MJ_CREATE instrui o dispositivo a conectar o KSPIN_CONNECT de origem. PinId fixar no KSPIN_CONNECT. Instância de pin PinToHandle. Caso contrário, essa é uma solicitação de um cliente para conexão com o KSPIN_CONNECT. PinId pin usando o KSPIN_CONNECT. Método médio e um formato de dados específico especificado após a estrutura de conexão. Em ambos os casos, o driver do dispositivo poderá falhar nessa solicitação se essa conexão não puder ser aceita.

Requisitos

Requisito Valor
Cabeçalho ks.h (inclua Ks.h)

Confira também

KSPIN_INTERFACE

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin