Função NdisMCoIndicateStatusEx (ndis.h)

Artigo
02/26/2024

A função NdisMCoIndicateStatusEx relata uma alteração no status de um adaptador de miniporto CoNDIS.

Sintaxe

void NdisMCoIndicateStatusEx(
  [in]           NDIS_HANDLE             MiniportAdapterHandle,
  [in, optional] NDIS_HANDLE             NdisVcHandle,
  [in]           PNDIS_STATUS_INDICATION StatusIndication
);

Parâmetros

[in] MiniportAdapterHandle

O identificador do adaptador de miniport que o NDIS passou no parâmetro MiniportAdapterHandle do Função MiniportInitializeEx .

[in, optional] NdisVcHandle

Um identificador que identifica a VC (conexão virtual). O driver de miniporte obteve esse identificador como um parâmetro de entrada para sua função MiniportCoCreateVc , quando um cliente configurou uma chamada de saída ou quando o gerenciador de chamadas criou uma VC para um SAP (ponto de acesso de serviço registrado pelo cliente). O gerenciador de chamadas criou a VC para indicar uma notificação de chamada de entrada. Para enviar a indicação status para todas as associações de protocolo, defina esse parâmetro como NULL.

[in] StatusIndication

Um ponteiro para uma estrutura NDIS_STATUS_INDICATION que contém as informações de status.

Retornar valor

Nenhum

Comentários

Quando um driver de miniporto chama NdisMCoIndicateStatusEx com um identificador VC NULL para o parâmetro NdisVcHandle, o NDIS encaminha a notificação de alteração de status para todos os drivers de protocolo associados chamando a função ProtocolCoStatusEx de cada driver de protocolo associado. Uma chamada para NdisMCoIndicateStatusEx com um identificador VC não NULL restringe a notificação de status a clientes ou gerentes de chamadas com os quais o driver de miniporto compartilha essa alça de VC.

Um driver de miniporto pode chamar NdisMCoIndicateStatusEx depois de definir seus atributos de registro, chamando o A função NdisMSetMiniportAttributes da função MiniportInitializeEx , mesmo que o driver ainda esteja no contexto da função MiniportInitializeEx . O driver não deve chamar NdisMCoIndicateStatusEx depois de retornar da função MiniportHaltEx .

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	<= DISPATCH_LEVEL
Regras de conformidade de DDI	Irql_MCO_Function(ndis)