Función NdisMIdleNotificationConfirm (ndis.h)
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.
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.
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