KSPIN_CONNECT estrutura (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 estiver 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 em comunicações, esse é o método implícito de dizer a ele como ele deve agir na conexão.
PinToHandle
Especifica para qual tipo de pino de destino a criação se destina e, no caso de um destino de origem, ao qual fixar para se conectar. Esse membro é NULL quando um cliente solicita uma conexão para si mesmo. Caso contrário, ele será o destino da solicitação de conexão. No caso de um destino de origem, isso 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 da conexão, geralmente KSPRIORITY_NORMAL. Consulte a propriedade KSPROPERTY_CONNECTION_PRIORITY para obter detalhes.
Observações
Se o KSPIN_CONNECT. O elemento PinToHandle não é NULL, IRP_MJ_CREATE instrui o dispositivo a conectar o KSPIN_CONNECT de origem. Fixar PinId na KSPIN_CONNECT. Instância do pin PinToHandle. Caso contrário, essa é uma solicitação de um cliente para conexão com o KSPIN_CONNECT. Fixar PinId 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 (incluir Ks.h) |