Funzione NdisMIdleNotificationConfirm (ndis.h)

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

I driver Miniport chiamano questa funzione durante un'operazione di sospensione selettiva di 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

L'handle della scheda di rete passato 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 dello stato a bassa potenza.

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 MiniportIdleNotification del driver. Chiamando NdisMIdleNotificationConfirm, il driver notifica all'NDIS che l'operazione di sospensione può iniziare e la scheda di rete può essere passata a uno stato a bassa potenza. In questa chiamata, il driver miniport imposta il parametro IdlePowerState sullo stato di alimentazione più basso a cui il dispositivo può passare.

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

Ad esempio, quando NDIS chiama la funzione MiniportIdleNotification , il driver miniport USB rilascia il pacchetto di richiesta I/O specifico del bus di 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 bassa potenza, 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 della richiesta di inattività USB.

Nota Un driver miniport non deve chiamare NdisMIdleNotificationConfirm per una notifica inattiva completata in precedenza. Il driver miniport completa la notifica inattiva chiamando NdisMIdleNotificationComplete.
 
Per altre informazioni su come gestire le notifiche di inattività di sospensione selettiva di NDIS, vedere Gestione della notifica di inattività di sospensione selettiva di NDIS.

Requisiti

   
Client minimo supportato Supportato in NDIS 6.30 e versioni successive.
Piattaforma di destinazione Universale
Intestazione ndis.h (includere Ndis.h)
Libreria Ndis.lib
IRQL PASSIVE_LEVEL

Vedi anche

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete