OID_PM_CURRENT_CAPABILITIES
Como consulta, los controladores que se sobreponen pueden usar el OID de OID_PM_CURRENT_CAPABILITIES para consultar las funcionalidades de administración de energía disponibles actualmente de un adaptador de red. 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 de NDIS_PM_CAPABILITIES .
Observaciones
NDIS controla la consulta de controladores de minipuerto. A partir de NDIS 6.20, los controladores de minipuerto proporcionan las funcionalidades de hardware de administración de energía durante la inicialización. Sin embargo, NDIS puede ocultar algunas funcionalidades del controlador de protocolo. Por ejemplo, NDIS podría notificar diferentes funcionalidades cuando un usuario deshabilita algunas o todas las funcionalidades de administración de energía.
Tenga en cuenta que las funcionalidades actuales de administración de energía que NDIS informa a un controlador de protocolo no son necesariamente las mismas que las funcionalidades de hardware que el controlador de minipuerto notificó a NDIS.
NDIS informa de las funcionalidades de administración de energía de un adaptador de red subyacente a controladores de protocolo excesivos en el miembro PowerManagementCapabilitiesEx de la estructura NDIS_BIND_PARAMETERS durante la operación de enlace. Por lo tanto, los controladores de protocolo no tienen que consultar el OID.
NDIS emite una indicación de estado de NDIS_STATUS_PM_CAPABILITIES_CHANGE para informar de los cambios en las funcionalidades de administración de energía que están disponibles para los controladores de exceso.
Si el adaptador de red subyacente tiene un controlador de miniporte NDIS 6.1 o anterior, NDIS traduce las capacidades de administración de energía del adaptador de red subyacente a una estructura de NDIS_PM_CAPABILITIES .
NDIS devuelve uno de los siguientes códigos de estado para la solicitud:
NDIS_STATUS_SUCCESS
La solicitud se completó correctamente. InformationBuffer apunta a una estructura de NDIS_PM_CAPABILITIES.
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. BytesNeeded miembro de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario.
NDIS_STATUS_FAILURE
Error en la solicitud por motivos distintos de los motivos anteriores.
Requisitos
Versión |
Compatible con NDIS 6.20 y versiones posteriores. No se solicita para los conductores de miniport. (Vea la sección Comentarios.) |
Encabezado |
Ntddndis.h (include Ndis.h) |