OID_PM_PARAMETERS
Como consulta, los controladores de protocolo pueden usar el OID de OID_PM_PARAMETERS para consultar las funcionalidades de hardware de administración de energía de un adaptador de red habilitado actualmente. Después de una devolución correcta de la solicitud de consulta OID, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura NDIS_PM_PARAMETERS .
Como conjunto, los controladores de protocolo pueden usar el OID de OID_PM_PARAMETERS para habilitar o deshabilitar las funcionalidades de hardware actuales de un adaptador de red. El controlador de protocolo proporciona un puntero a una estructura de NDIS_PM_PARAMETERS en el miembro InformationBuffer de la estructura NDIS_OID_REQUEST .
Observaciones
A partir de NDIS 6.20, los controladores de filtro y protocolo excesivo usan OID_PM_PARAMETERS para consultar y establecer las funcionalidades de hardware de administración de energía de un adaptador de red habilitado actualmente.
Cuando un controlador de sobreasignación consulta el OID_PM_PARAMETERS OID, NDIS completa la solicitud sin reenviarlo al controlador de minipuerto. NDIS almacena la configuración solicitada y las combina con la configuración de otras solicitudes de este tipo. Antes de que NDIS realice la transición del adaptador de red al estado de baja potencia, NDIS envía una solicitud establecida al controlador de minipuerto que contiene la configuración combinada de todas las solicitudes almacenadas por NDIS.
Las funcionalidades que están habilitadas actualmente pueden ser un subconjunto de las funcionalidades que admite el hardware. Para obtener más información sobre las funcionalidades que admite el hardware, consulte OID_PM_HARDWARE_CAPABILITIES.
Nota Si NDIS establece la marca NDIS_PM_SELECTIVE_SUSPEND_ENABLED en el miembro WakeUpFlags de NDIS_PM_PARAMETERS estructura, emite la solicitud de conjunto de OID de OID_PM_PARAMETERS directamente al controlador de miniport. Esto permite que NDIS omita el procesamiento mediante controladores de filtro en la pila de controladores de red.
NDIS o el controlador de minipuerto devuelven uno de los siguientes códigos de estado para la solicitud:
NDIS_STATUS_SUCCESS
La solicitud se completó correctamente.
NDIS_STATUS_PENDING
La solicitud está pendiente de finalización. NDIS pasará el código de estado final y los resultados al controlador de finalización de solicitudes OID del autor de la llamada una vez completada la solicitud.
NDIS_STATUS_BUFFER_TOO_SHORT
El búfer de información era demasiado corto. NDIS establece los DATOS. QUERY_INFORMATION. Miembro BytesNeeded de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario.
NDIS_STATUS_INVALID_PARAMETER
Error en la solicitud porque intentó habilitar una funcionalidad que el adaptador de red subyacente no admite.
NDIS_STATUS_FAILURE
Error en la solicitud por motivos distintos de los motivos anteriores.
Requisitos
Versión |
Se admite en NDIS 6.20 y versiones posteriores. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |