Função NdisCmRegisterSapComplete (ndis.h)

Artigo
03/01/2024

NdisCmRegisterSapComplete retorna a status final da solicitação de um cliente, para a qual o CM retornou anteriormente NDIS_STATUS_PENDING, para registrar um SAP.

Sintaxe

void NdisCmRegisterSapComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisSapHandle,
  [in] NDIS_HANDLE CallMgrSapContext
);

Parâmetros

[in] Status

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

[in] NdisSapHandle

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 seu Função ProtocolCmRegisterSap .

[in] CallMgrSapContext

Especifica o identificador para uma área de contexto residente fornecida pelo chamador na qual o CM mantém o estado para esse SAP se o registro for bem-sucedido. Nesse caso, o NDIS passa esse identificador de volta para o CM 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 gerenciador de chamadas autônomo deve chamar NdisCmRegisterSapComplete se a função ProtocolCmRegisterSap retornar NDIS_STATUS_PENDING quando foi chamada com o NdisSapHandle fornecido. A chamada para NdisCmRegisterSapComplete faz com que o NDIS chame o cliente Função ProtocolClRegisterSapComplete .

Se o gerenciador de chamadas definir Status como algo diferente de NDIS_STATUS_SUCCESS, ele deverá considerar o NdisSapHandle inválido assim que chamar NdisCmRegisterSapComplete. Depois de falhar em um registro SAP, o CM pode liberar ou reutilizar a área de contexto por SAP alocada quando NdisCmRegisterSapComplete retornar o controle. O NDIS também libera seu contexto para o SAP se o gerenciador de chamadas falhar no registro.

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

Requisitos

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