Compartir a través de


OID_PM_WOL_PATTERN_LIST

Como consulta, los controladores demasiado excesivos 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 InformationBuffer miembro de la estructura de 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 miniport. 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 NextWoLPatternOffset miembro al desplazamiento desde el principio del búfer de información de OID (es decir, el principio del búfer al que apunta el InformationBuffer miembro de la estructura NDIS_OID_REQUEST) al principio de la siguiente estructura de NDIS_PM_WOL_PATTERN de la lista. El desplazamiento de la nextWoLPatternOffset miembro 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 ningún patrón WOL establecido en el adaptador de red, NDIS establece el DATA. QUERY_INFORMATION. BytesWritten miembro de la estructura de NDIS_OID_REQUEST en cero y devuelve NDIS_STATUS_SUCCESS para la solicitud. Los datos de la DATA. QUERY_INFORMATION. NDIS no modifica el miembro InformationBuffer.

NDIS devuelve uno de los siguientes códigos de estado para la solicitud:

NDIS_STATUS_SUCCESS
La solicitud se completó correctamente. El informationBuffer de 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 el DATA. 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

Se admite en NDIS 6.20 y versiones posteriores. No se solicita para controladores de miniport. (Consulte la sección Comentarios).

Encabezado

Ntddndis.h (include Ndis.h)

Consulte también

NDIS_OID_REQUEST

NDIS_PM_WOL_PATTERN

OID_PM_ADD_WOL_PATTERN

OID_PM_REMOVE_WOL_PATTERN

OID_PNP_WAKE_UP_PATTERN_LIST