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 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.

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.

Requisiti

Vedi anche

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete