OID_PNP_ADD_WAKE_UP_PATTERN
El OID de OID_PNP_ADD_WAKE_UP_PATTERN se envía mediante un controlador de protocolo a un controlador de minipuerto para especificar un patrón de reactivación. El patrón de reactivación, junto con su máscara, se describe mediante una estructura de NDIS_PM_PACKET_PATTERN .
Un protocolo que habilita la reactivación de coincidencia de patrones para un controlador de minipuerto (consulte OID_PNP_ENABLE_WAKE_UP) usa OID_PNP_ADD_WAKE_UP_PATTERN para especificar un patrón de reactivación. El patrón de reactivación se puede almacenar en memoria de host o en el adaptador de red, en función de las funcionalidades del adaptador de red.
El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene lo siguiente:
Estructura NDIS_PM_PACKET_PATTERN que proporciona información sobre el patrón y su máscara.
Máscara que indica qué bytes de un paquete entrante se deben comparar con los bytes correspondientes del patrón. La máscara comienza con el primer byte del paquete. La máscara sigue inmediatamente la estructura de NDIS_PM_PACKET_PATTERN en InformationBuffer. Para obtener más información sobre cómo funciona esta máscara, consulte la especificación de referencia de administración de energía de clase de dispositivo de red.
Patrón de reactivación, que comienza bytes PatternOffset desde el principio de InformationBuffer. Para obtener más información sobre los patrones de reactivación, consulte la especificación de referencia de administración de energía de clase de dispositivo de red.
El número de patrones de reactivación que el controlador de miniporte puede aceptar de un protocolo puede depender de la disponibilidad de los recursos, como la memoria del host que el controlador de miniporte ha asignado para estos patrones o el almacenamiento disponible en el adaptador de red. Si un controlador de minipuerto no puede agregar un patrón de reactivación debido a recursos insuficientes, el controlador de minipuerto devuelve NDIS_STATUS_RESOURCES en respuesta a OID_PNP_ADD_WAKE_UP_PATTERN.
Si un controlador de protocolo intenta agregar un patrón duplicado, el controlador de minipuerto debe devolver NDIS_STATUS_INVALID_DATA en respuesta a OID_PNP_ADD_WAKE_UP_PATTERN.
Un controlador intermedio en el que el borde superior recibe esta solicitud de OID siempre debe propagar la solicitud al controlador de miniporte subyacente llamando a NdisRequest o NdisCoRequest.
Requisitos
Versión |
Compatible con NDIS 6.0 y NDIS 6.1. Para NDIS 6.20 y versiones posteriores, use OID_PM_ADD_WOL_PATTERN en su lugar. |
Encabezado |
Ntddndis.h (include Ndis.h) |