Macro NdisMCmRegisterSapComplete (ndis.h)

Artigo
02/26/2024

NdisMCmRegisterSapComplete retorna a status final da solicitação de um cliente, para a qual o driver MCM

A função ProtocolCmRegisterSap retornou anteriormente NDIS_STATUS_PENDING, para registrar um SAP.

Sintaxe

void NdisMCmRegisterSapComplete(
   _S_,
   _H_,
   _C_
);

Parâmetros

_S_

Especifica o status final da solicitação original do cliente para registrar o SAP, seja NDIS_STATUS_SUCCESS ou qualquer NDIS_STATUS_XXX determinado pelo chamador, exceto NDIS_STATUS_PENDING.

_H_

Especifica o identificador fornecido pelo NDIS para o SAP se o registro for bem-sucedido. O gerenciador de chamadas obteve esse identificador como um parâmetro de entrada para sua função ProtocolCmRegisterSap .

_C_

Especifica o identificador para uma área de contexto residente fornecida pelo chamador na qual o driver MCM mantém o estado para esse SAP se o registro for bem-sucedido. Nesse caso, o NDIS passa esse identificador de volta para o driver MCM em todas as chamadas subsequentes relacionadas a esse SAP. Se Status for definido como algo diferente de NDIS_STATUS_SUCCESS, o NDIS ignorará esse parâmetro.

Retornar valor

Nenhum

Comentários

Um driver MCM deve chamar NdisMCmRegisterSapComplete se sua função ProtocolCmRegisterSap retornar NDIS_STATUS_PENDING quando foi chamada com o NdisSapHandle fornecido. A chamada para NdisMCmRegisterSapComplete faz com que o NDIS chame o cliente Função ProtocolClRegisterSapComplete .

Se o driver MCM definir Status como algo diferente de NDIS_STATUS_SUCCESS, ele deverá considerar o NdisSapHandle inválido quando NdisMCmRegisterSapComplete retornar o controle. Depois de falhar em um registro SAP, o CM pode liberar ou reutilizar a área de contexto por SAP, se houver, que ela já alocou. O NDIS também libera seu contexto para o SAP se o driver MCM falhar no registro.

Somente os drivers de miniporto orientados a conexão que fornecem suporte integrado ao gerenciamento de chamadas podem chamar NdisMCmRegisterSapComplete. Os gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, chamam NdisCmRegisterSapComplete .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisMCmRegisterSapComplete (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisMCmRegisterSapComplete (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
IRQL	<= DISPATCH_LEVEL
Regras de conformidade da DDI	Irql_MCM_Function(ndis)