Função NdisCmNotifyCloseAddressFamily (ndis.h)

Artigo
02/29/2024

A função NdisCmNotifyCloseAddressFamily notifica o NDIS de que um gerenciador de chamadas está desassociando de um adaptador de miniporto subjacente e que todos os clientes CoNDIS associados devem fechar a AF (família de endereços) especificada.

Sintaxe

NDIS_STATUS NdisCmNotifyCloseAddressFamily(
  [in] NDIS_HANDLE NdisAfHandle
);

Parâmetros

[in] NdisAfHandle

Um identificador NDIS que identifica o AF que o NDIS deve fechar. O NDIS forneceu esse identificador para a função ProtocolCmOpenAf do gerenciador de chamadas.

Retornar valor

NdisCmNotifyCloseAddressFamily pode retornar um dos seguintes:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	O NDIS fechou com êxito a família de endereços.
NDIS_STATUS_PENDING	O NDIS está tratando essa solicitação de forma assíncrona e chamará o do gerenciador de chamadas Função ProtocolCmNotifyCloseAfComplete quando a operação de fechamento for concluída.
NDIS_STATUS_XXX	Falha no NDIS na solicitação por algum motivo determinado pelo driver do cliente ou NDIS.

Comentários

Gerenciadores de chamadas autônomos do CoNDIS, que se registram como drivers de protocolo NDIS chamando o A função NdisRegisterProtocolDriver pode chamar a função NdisCmNotifyCloseAddressFamily . Miniportar MCMs (gerenciadores de chamadas) em vez de chamar o Função NdisMCmNotifyCloseAddressFamily .

Para fechar um AF para uma associação, o gerenciador de chamadas autônomo deve chamar NdisCmNotifyCloseAddressFamily do Função ProtocolUnbindAdapterEx . O NDIS, em seguida, chama o Função ProtocolClNotifyCloseAf do cliente que tem o AF especificado aberto.

Se NdisCmNotifyCloseAddressFamily retornar NDIS_STATUS_PENDING, o NDIS chamará o do gerenciador de chamadas Função ProtocolCmNotifyCloseAfComplete depois que o cliente conclui a operação de fechamento de AF.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDIS 6.0 e posterior.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	PASSIVE_LEVEL
Regras de conformidade da DDI	Irql_CallManager_Function(ndis)