Macro NdisMCmRegisterSapComplete (ndis.h)

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

Confira também

NdisClRegisterSap

NdisCmRegisterSapComplete

NdisMCmDispatchIncomingCall

ProtocolCmRegisterSap