Funzione NdisMIdleNotificationConfirm (ndis.h)

  • Articolo

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

La scheda di rete gestisce l'NDIS passata 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 MiniportIdleNotification del driver. Chiamando NdisMIdleNotificationConfirm, il driver notifica all'NDIS che l'operazione di sospensione può essere avviata e che 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 richiesta 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 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 Implementing a USB Idle Request IRP Callback Routine.For more information, see Implementing a USB Idle Request IRP Callback Routine.

Nota Un driver miniport non deve chiamare NdisMIdleNotificationConfirm per una notifica di inattività 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à selettiva NDIS.

Requisiti

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

Vedi anche

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete