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
| 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) |