estructura KSPIN_CONNECT (ks.h)

Los clientes usan la estructura KSPIN_CONNECT para describir la conexión que solicitan desde un controlador en una llamada de KsCreatePin.

Sintaxis

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

Miembros

Interface

Especifica el KSPIN_INTERFACE que se va a usar para esta conexión.

Medium

Estructura de tipo KSPIN_MEDIUM que especifica el medio que se va a usar para esta conexión.

PinId

Especifica el número de identificador de tipo de patilla. Si el campo PinToHandle no es NULL, este campo contiene el identificador del pin de origen al que se envía la solicitud. De lo contrario, este campo hace referencia al pin receptor al que se está conectando. Si un pin puede admitir ser un origen y un receptor en las comunicaciones, este es el método implícito de indicarle cómo debe actuar en la conexión.

PinToHandle

Especifica a qué tipo de pin de destino está destinado la creación y, en el caso de un destino de origen, a qué pin se va a conectar. Este miembro es NULL cuando un cliente solicita una conexión a sí mismo. De lo contrario, es el destino de la solicitud de conexión. En el caso de un destino de origen, contiene el identificador de la instancia de anclaje para establecer una conexión. En el caso de un destino receptor, este campo contiene NULLy no se usa de otro modo.

Priority

Estructura de tipo KSPRIORITY que especifica la prioridad de la conexión, normalmente KSPRIORITY_NORMAL. Consulte la propiedad KSPROPERTY_CONNECTION_PRIORITY para obtener más información.

Observaciones

Si el KSPIN_CONNECT. El elemento PinToHandle no es null, IRP_MJ_CREATE indica al dispositivo que conecte el KSPIN_CONNECT de origen. PinId ancla al KSPIN_CONNECT. Instancia de pinToHandle. De lo contrario, se trata de una solicitud de un cliente para la conexión a la KSPIN_CONNECT. PinId pin mediante el KSPIN_CONNECT. Método medio y un formato de datos específico especificado después de la estructura de conexión. En cualquier caso, el controlador de dispositivo puede producir un error en esta solicitud si no se puede aceptar esta conexión.

Requisitos

Requisito	Valor
encabezado de	ks.h (incluya Ks.h)

Consulte también

KSPIN_INTERFACE

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin