Funzione NdisMIdleNotificationConfirm (ndis.h)

Articolo
02/07/2025

I driver Miniport chiamano NdisMIdleNotificationConfirm per notificare a NDIS che la scheda di rete inattiva può essere sospesa e passata a uno stato a basso consumo.

I driver Miniport chiamano questa funzione durante un'operazione di sospensione selettiva NDIS. NDIS avvia l'operazione quando chiama la funzione del gestore miniportIdleNotification del driver.

Sintassi

void NdisMIdleNotificationConfirm(
  [in] NDIS_HANDLE             MiniportAdapterHandle,
  [in] NDIS_DEVICE_POWER_STATE IdlePowerState
);

Parametri

[in] MiniportAdapterHandle

Handle della scheda di rete passato NDIS al parametro MiniportAdapterHandle di MiniportInitializeEx.

[in] IdlePowerState

Valore di enumerazione NDIS_DEVICE_POWER_STATE che specifica lo stato di alimentazione più basso supportato dalla scheda di rete per una transizione di stato a basso consumo.

Nota Per le schede di rete USB, questo parametro deve essere NdisDeviceStateD2.

Valore restituito

Nessuno

Osservazioni

I driver Miniport chiamano NdisMIdleNotificationConfirm dopo che NDIS chiama la funzione miniportIdleNot ification del driver. Chiamando NdisMIdleNotificationConfirm, il driver notifica all'NDIS che l'operazione di sospensione può essere avviata e la scheda di rete può essere passata a uno stato a basso consumo. In questa chiamata, il driver miniport imposta il parametro IdlePowerState sullo stato di alimentazione più basso a cui il dispositivo può eseguire la transizione.

Prima che il driver miniport chiami NdisMIdleNotificationConfirm, deve emettere pacchetti di richieste di I/O specifici del bus che potrebbero essere necessari per sospendere in modo selettivo la scheda di rete.

Ad esempio, quando NDIS chiama la funzione miniportIdleNotification, il driver miniport USB rilascia il pacchetto di richiesta di I/O specifico del bus (IRP) per una richiesta di inattività USB (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) al driver del bus USB. Quando il driver del bus USB conferma che la scheda di rete può passare a uno stato a basso consumo, chiama la routine di callback associata all'IRP. Nel contesto della routine di callback, il driver miniport USB chiama NdisMIdleNotificationConfirm. Per altre informazioni, vedere Implementazione di una routine di callback IRP di richiesta inattiva USB.

Nota Un driver miniport non deve chiamare NdisMIdleNotificationConfirm per una notifica inattiva completata in precedenza. Il driver miniport completa la notifica di inattività chiamando NdisMIdleNotificationComplete.

Per altre informazioni su come gestire le notifiche di inattività di sospensione selettiva NDIS, vedere Gestione della notifica di inattività di sospensione selettiva NDIS.

Fabbisogno

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

Vedere anche

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete

Condividi tramite