Función NdisMIdleNotificationConfirm (ndis.h)

Los controladores de miniportan llaman a NdisMIdleNotificationConfirm para notificar a NDIS que el adaptador de red inactivo se puede suspender y pasar de forma segura a un estado de baja potencia.

Los controladores de miniportar llaman a esta función durante una operación de suspensión selectiva de NDIS. NDIS inicia la operación cuando llama a la función de controlador MiniportIdleNotification.

Sintaxis

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

Parámetros

[in] MiniportAdapterHandle

Identificador del adaptador de red que NDIS pasó al parámetro MiniportAdapterHandle de MiniportInitializeEx.

[in] IdlePowerState

Valor de enumeración NDIS_DEVICE_POWER_STATE que especifica el estado de energía más bajo que admite el adaptador de red para una transición de estado de baja potencia.

Nota Para adaptadores de red USB, este parámetro debe ser NdisDeviceStateD2.

 

Valor devuelto

Ninguno

Observaciones

Los controladores de miniport llaman NdisMIdleNot ificationConfirm después de que NDIS llame a la función MiniportIdleNotification del controlador. Mediante una llamada a NdisMIdleNotificationConfirm, el controlador notifica a NDIS que la operación de suspensión puede iniciarse y el adaptador de red se puede pasar a un estado de baja potencia. En esta llamada, el controlador de miniporte establece el parámetro IdlePowerState en el estado de energía más bajo al que el dispositivo puede realizar la transición.

Antes de que el controlador de miniporte llame a NdisMIdleNotificationConfirm, debe emitir los paquetes de solicitud de E/S (IRP) específicos del bus que puedan ser necesarios para suspender selectivamente el adaptador de red.

Por ejemplo, cuando NDIS llama a la función MiniportIdleNotification, el controlador de miniporte USB emite el paquete de solicitud de E/S específico del bus (IRP) para una solicitud de inactividad USB (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) al controlador del bus USB. Cuando el controlador de bus USB confirma que el adaptador de red puede pasar a un estado de baja potencia, llama a la rutina de devolución de llamada asociada al IRP. En el contexto de la rutina de devolución de llamada, el controlador de miniport USB llama a NdisMIdleNotificationConfirm. Para obtener más información, consulte Implementación de una rutina de devolución de llamada IRP de solicitud inactiva USB.

Nota Un controlador de miniporte no debe llamar a NdisMIdleNotificationConfirm para una notificación inactiva que se completó anteriormente. El controlador de miniporta completa la notificación inactiva llamando a NdisMIdleNotificationComple.

 

Para obtener más información sobre cómo controlar las notificaciones de suspensión inactiva selectiva de NDIS, consulte Control de la notificación de suspensión inactiva selectiva de NDIS.

Requisitos

Requisito	Valor
cliente mínimo admitido	Compatible con NDIS 6.30 y versiones posteriores.
de la plataforma de destino de	Universal
encabezado de	ndis.h (incluya Ndis.h)
biblioteca de	Ndis.lib
irQL	PASSIVE_LEVEL

Consulte también

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

miniportIdleNotification

NdisMIdleNotificationComplete