Funzione NdisMCoIndicateStatusEx (ndis.h)

Articolo
02/26/2024

La funzione NdisMCoIndicateStatusEx segnala una modifica dello stato di una scheda miniport CoNDIS.

Sintassi

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

Parametri

[in] MiniportAdapterHandle

Handle dell'adattatore miniport passato dal parametro MiniportAdapterHandle del parametro NDIS Funzione MiniportInitializeEx .

[in, optional] NdisVcHandle

Handle che identifica la connessione virtuale (VC). Il driver miniport ha ottenuto questo handle come parametro di input per la funzione MiniportCoCreateVc , quando un client configura una chiamata in uscita o quando il gestore chiamate ha creato un VC per un punto di accesso al servizio registrato dal client (SAP). Gestione chiamate ha creato il vc per indicare una notifica di chiamata in ingresso. Per inviare l'indicazione dello stato a tutte le associazioni di protocollo, impostare questo parametro su NULL.

[in] StatusIndication

Puntatore a una struttura NDIS_STATUS_INDICATION contenente le informazioni sullo stato.

Valore restituito

nessuno

Osservazioni

Quando un driver miniport chiama NdisMCoIndicateStatusEx con un handle VC NULL per il parametro NdisVcHandle , NDIS inoltra la notifica di modifica dello stato a tutti i driver di protocollo associati chiamando ogni funzione ProtocolCoStatusEx del driver del protocollo associato. Una chiamata a NdisMCoIndicateStatusEx con un handle VC non NULL limita la notifica dello stato ai client o ai gestori di chiamate con cui il driver miniport condivide questo handle VC.

Un driver miniport può chiamare NdisMCoIndicateStatusEx dopo aver impostato gli attributi di registrazione, chiamando l'oggetto Funzione NdisMSetMiniportAttributes dalla funzione MiniportInitializeEx , anche se il driver è ancora nel contesto della funzione MiniportInitializeEx . Il driver non deve chiamare NdisMCoIndicateStatusEx dopo che restituisce dalla funzione MiniportHaltEx .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (includere Ndis.h)
Libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	Irql_MCO_Function(ndis)