MINIPORT_CANCEL_IDLE_NOTIFICATION funzione di callback (ndis.h)

Articolo
02/07/2025

NDIS chiama la funzione del gestore MiniportCancelIdleNotification per notificare al driver miniport che NDIS ha rilevato attività nella scheda di rete sospesa. Per questo motivo, NDIS annulla la notifica di inattività in modo che la scheda di rete possa essere passata a uno stato di alimentazione completa.

Sintassi

MINIPORT_CANCEL_IDLE_NOTIFICATION MiniportCancelIdleNotification;

void MiniportCancelIdleNotification(
  [in] NDIS_HANDLE MiniportAdapterContext
)
{...}

Parametri

[in] MiniportAdapterContext

Handle per un'area di contesto allocata dal driver miniport nella relativa funzione MiniportInitializeEx. Il driver miniport usa questa area di contesto per mantenere le informazioni sullo stato per una scheda di rete.

Valore restituito

Nessuno

Osservazioni

La funzione del gestore MiniportCancelIdleNotification è necessaria per i driver miniport che supportano l'interfaccia di sospensione selettiva NDIS. Per altre informazioni sul modo in cui il driver registra le funzioni del gestore di sospensione selettiva, vedere Registrazione delle funzioni del gestore di sospensione selettiva NDIS.

NDIS chiama il driver miniport MiniportIdleNotification funzione del gestore per avviare un'operazione di sospensione selettiva NDIS in una scheda di rete inattiva. Dopo che la scheda di rete è stata sospesa e passata a uno stato a basso consumo, NDIS può annullare la notifica di inattività in sospeso se una delle condizioni seguenti è vera:

Un protocollo overlying o un driver di filtro genera una richiesta di invio di pacchetti o una richiesta OID al driver miniport.
L'adattatore sottostante segnala un evento di riattivazione, ad esempio la ricezione di un pacchetto che corrisponde a un modello di riattivazione LAN (WOL) o il rilevamento di una modifica nello stato della connessione multimediale.

NDIS annulla la notifica di inattività chiamando MiniportCancelIdleNotification. Quando questa funzione del gestore viene chiamata, il driver miniport annulla prima qualsiasi pacchetto di richiesta di I/O specifico del bus (IRP) che potrebbe essere stato emesso in precedenza per la notifica di inattività. Infine, il driver miniport chiama NdisMIdleNotificationComplete per completare la notifica di inattività.

Per altre informazioni su come NDIS annulla la notifica di inattività, vedere Annullamento della notifica di inattività selettiva NDIS.

Per linee guida su come implementare la MiniportCancelIdleNotification routine di completamento del gestore e IRP, vedere Implementazione di una funzione del gestore MiniportCancelIdleNotification.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato in NDIS 6.30 e versioni successive.
piattaforma di destinazione	Finestre
intestazione	ndis.h (include Ndis.h)
IRQL	PASSIVE_LEVEL

Vedere anche

IoCancelIrp

MiniportIdleNotification

NdisMIdleNotificationComplete

Condividi tramite