Função NdisCmRegisterSapComplete (ndis.h)
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) |