OID_PM_WOL_PATTERN_LIST
Como consulta, los controladores de exceso pueden usar el OID de OID_PM_WOL_PATTERN_LIST para enumerar los patrones de reactivación en LAN que se establecen en un adaptador de red subyacente. Después de una devolución correcta de la consulta, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una lista de estructuras de NDIS_PM_WOL_PATTERN que describen los patrones WOL agregados actualmente.
Observaciones
NDIS controla la consulta de controladores de minipuerto. Los controladores NDIS pueden usar el OID de OID_PM_WOL_PATTERN_LIST para obtener una lista de patrones de reactivación en LAN que se establecen en un adaptador de red subyacente.
Para cada estructura de NDIS_PM_WOL_PATTERN de la lista, NDIS establece el miembro NextWoLPatternOffset en el desplazamiento desde el principio del búfer de información de OID (es decir, el principio del búfer al que apunta el miembro InformationBuffer de la estructura NDIS_OID_REQUEST ) al principio de la siguiente estructura NDIS_PM_WOL_PATTERN de la lista. El desplazamiento del miembro NextWoLPatternOffset de la última estructura de la lista es cero.
Para desplazamientos en una estructura de NDIS_PM_WOL_PATTERN distinta de NextWoLPatternOffset (por ejemplo, NameBufferOffset), NDIS proporciona desplazamientos relativos al principio de cada estructura de NDIS_PM_WOL_PATTERN .
Si no hay patrones WOL establecidos en el adaptador de red, NDIS establece data . QUERY_INFORMATION. BytesEscrito miembro de la estructura de NDIS_OID_REQUEST en cero y devuelve NDIS_STATUS_SUCCESS para la solicitud. Los datos dentro de DATA. QUERY_INFORMATION. El miembro InformationBuffer no lo modifica NDIS.
NDIS devuelve uno de los siguientes códigos de estado para la solicitud:
NDIS_STATUS_SUCCESS
La solicitud se completó correctamente. InformationBuffer contiene un puntero a una lista de patrones WOL, si los hay.
NDIS_STATUS_PENDING
La solicitud está pendiente de finalización. El código de estado final y los resultados se pasarán al controlador de finalización de solicitudes OID del autor de la llamada.
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) |