Função KsValidateConnectRequest (ks.h)

Artigo
02/07/2025

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 especificando 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 de 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.

Valor de retorno

A função KsValidateConnectRequest retorna STATUS_SUCCESS se bem-sucedida ou retorna um erro.

Observações

A função KsValidateConnectRequest lida com exceções básicas de acesso à estrutura de conexão e valida os requisitos de comunicação, médio, protocolo e 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 subformato de intervalo será um curinga ou o formato principal do intervalo, o subformato 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 de acessar.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ks.h (incluir Ks.h)
biblioteca	Ks.lib

Compartilhar via