Función NdisMIdleNotificationConfirm (ndis.h)

  • Artículo

Los controladores de minipuerto 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 bajo consumo.

Los controladores de minipuerto 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 del controlador MiniportIdleNotification del controlador.

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

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

Valor devuelto

None

Observaciones

Los controladores de Miniport llaman a NdisMIdleNotificationConfirm después de que NDIS llame a la función MiniportIdleNotification del controlador. Al llamar a NdisMIdleNotificationConfirm, el controlador notifica al 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 minipuerto 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 minipuerto 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 bajo consumo, llama a la rutina de devolución de llamada asociada al IRP. Dentro del contexto de la rutina de devolución de llamada, el controlador de minipuerto 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 minipuerto no debe llamar a NdisMIdleNotificationConfirm para una notificación inactiva que se completó anteriormente. El controlador de minipuerto 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 Value
Cliente mínimo compatible Se admite en NDIS 6.30 y versiones posteriores.
Plataforma de destino Universal
Encabezado ndis.h (incluya Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL

Consulte también

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComple