Función KsValidateConnectRequest (ks.h)

  • Artículo

La función KsValidateConnectRequest valida una solicitud de conexión y devuelve un puntero a la estructura de conexión asociada a la solicitud.

Solo se puede llamar a esta función en PASSIVE_LEVEL.

Sintaxis

KSDDKAPI NTSTATUS KsValidateConnectRequest(
  [in]  PIRP                   Irp,
  [in]  ULONG                  DescriptorsCount,
  [in]  const KSPIN_DESCRIPTOR *Descriptor,
  [out] PKSPIN_CONNECT         *Connect
);

Parámetros

[in] Irp

Puntero a un IRP que especifica la solicitud de conexión.

[in] DescriptorsCount

Especifica el número de descriptores de anclaje pasados.

[in] Descriptor

Especifica un puntero a la lista de estructuras de KSPIN_DESCRIPTOR .

[out] Connect

Especifica una ubicación en la que se va a colocar un puntero al puntero KSPIN_CONNECT pasado a la solicitud de creación. Si KsValidateConnectRequest devuelve éxito, Connect+1 contendrá un puntero al KSDATAFORMAT con el que se abrió el pin.

Valor devuelto

La función KsValidateConnectRequest devuelve STATUS_SUCCESS si se ejecuta correctamente o devuelve un error.

Comentarios

La función KsValidateConnectRequest controla las excepciones de acceso a la estructura de conexión básicas y valida los requisitos de comunicación, el medio, el protocolo y el formato de datos básico. La validación realizada en el formato de datos pasado se basa en la lista de intervalos de datos para el pin especificado en el que se va a crear una instancia de patilla. La validación se realiza correctamente en tres instancias: si un formato principal de intervalo es un carácter comodín, el formato principal del intervalo coincide y el subformato de intervalo es un carácter comodín, o el formato principal del intervalo, el subformato de intervalo y el especificador de intervalo coinciden todos.

El búfer se pasa una copia del búfer de entrada original, si el originador no estaba en modo kernel y, por tanto, es seguro acceder.

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado ks.h (incluye Ks.h)
Library Ks.lib