MINIPORT_CANCEL_IDLE_NOTIFICATION funzione di callback (ndis.h)

  • Articolo

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 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 la funzione del gestore MiniportIdleNotification del driver miniport per avviare un'operazione di sospensione selettiva NDIS su 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 driver di protocollo o filtro eccessiva 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 corrispondente a un modello di riattivazione LAN (WOL) o il rilevamento di una modifica dello stato della connessione multimediale.
NDIS annulla la notifica di inattività chiamando MiniportCancelIdleNotification. Quando questa funzione del gestore viene chiamata, il driver miniport annulla prima di tutto tutti i pacchetti di richiesta di I/O specifici del bus che potrebbero essere stati rilasciati 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 funzione del gestore MiniportCancelIdleNotification e le routine di completamento IRP, vedere Implementazione di una funzione del gestore MiniportCancelIdleNotification.

Requisiti

Requisito Valore
Client minimo supportato Supportato in NDIS 6.30 e versioni successive.
Piattaforma di destinazione Windows
Intestazione ndis.h (include Ndis.h)
IRQL PASSIVE_LEVEL

Vedi anche

IoCancelIrp

MiniportIdleNotification

NdisMIdleNotificationComplete