Função NdisCmRegisterSapComplete (ndis.h)
NdisCmRegisterSapComplete retorna o 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 qualquerXXX NDIS_STATUS_ 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 estiver definido como algo diferente de NDIS_STATUS_SUCCESS, o NDIS ignorará esse parâmetro.
Valor de retorno
Nenhum
Observações
Um gerenciador de chamadas autônomo deve chamar NdisCmRegisterSapComplete se sua função ProtocolCmRegisterSap retornada NDIS_STATUS_PENDING quando foi chamada com o NdisSapHandle . A chamada para NdisCmRegisterSapComplete faz com que o NDIS chame o cliente função ProtocolClRegisterSapComplete.
Se o gerenciador de chamadas definir Status para qualquer outra coisa que não seja NDIS_STATUS_SUCCESS, ele deverá considerar a NdisSapHandle inválida assim que chamar NdisCmRegisterSapComplete. Depois de falhar um registro SAP, o CM pode liberar ou reutilizar a área de contexto por SAP alocada quando NdisCmRegisterSapComplete retorna o controle. O NDIS também libera seu contexto para o SAP se o gerenciador de chamadas falhar no registro.
Somente os gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, podem chamar NdisCmRegisterSapComplete. Drivers de miniporto orientados para conexão que fornecem chamada de suporte integrado de gerenciamento de chamadas NdisMCmRegisterSapComplete.