Função KsValidateConnectRequest (ks.h)

A função KsValidateConnectRequest valida uma solicitação de conexão e retorna um ponteiro para a estrutura de conexão associada à solicitação.

Essa função só pode ser chamada em PASSIVE_LEVEL.

Sintaxe

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

Parâmetros

[in] Irp

Ponteiro para um IRP que especifica a solicitação de conexão.

[in] DescriptorsCount

Especifica o número de descritores de pin passados.

[in] Descriptor

Especifica um ponteiro para a lista de estruturas de KSPIN_DESCRIPTOR .

[out] Connect

Especifica um local no qual colocar um ponteiro para o ponteiro KSPIN_CONNECT passado para a solicitação de criação. Se KsValidateConnectRequest retornar êxito , o Connect+1 conterá um ponteiro para o KSDATAFORMAT com o qual o pino foi aberto.

Retornar valor

A função KsValidateConnectRequest retornará STATUS_SUCCESS se tiver êxito ou retornará um erro.

Comentários

A função KsValidateConnectRequest lida com exceções básicas de acesso à estrutura de conexão e valida os requisitos de comunicação, o meio, o protocolo e o formato de dados básico. A validação executada no formato de dados passado baseia-se na lista de intervalo de dados para o pin especificado no qual uma instância de pin deve ser criada. A validação é bem-sucedida em três instâncias: se um formato principal de intervalo for um curinga, o formato principal do intervalo corresponderá e o subformulário de intervalo for um curinga ou o formato principal do intervalo, o subformatato de intervalo e o especificador de intervalo corresponderão a todos.

O buffer é passado uma cópia do buffer de entrada original, se o originador não estava no modo kernel e, portanto, é seguro para acessar.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	ks.h (inclua Ks.h)
Biblioteca	Ks.lib