OID_PNP_ADD_WAKE_UP_PATTERN
O OID_PNP_ADD_WAKE_UP_PATTERN OID é enviado por um driver de protocolo para um driver de miniporto para especificar um padrão de ativação. O padrão de ativação, juntamente com sua máscara, é descrito por uma estrutura NDIS_PM_PACKET_PATTERN .
Um protocolo que permite a ativação de correspondência de padrões para um driver de miniporta (consulte OID_PNP_ENABLE_WAKE_UP) usa OID_PNP_ADD_WAKE_UP_PATTERN para especificar um padrão de ativação. O padrão de ativação pode ser armazenado na memória do host ou no adaptador de rede, dependendo dos recursos do adaptador de rede.
O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém o seguinte:
Uma estrutura NDIS_PM_PACKET_PATTERN que fornece informações sobre o padrão e sua máscara.
Uma máscara que indica quais bytes de um pacote de entrada devem ser comparados com os bytes correspondentes no padrão. A máscara começa com o primeiro byte do pacote. A máscara segue imediatamente a estrutura NDIS_PM_PACKET_PATTERN no InformationBuffer. Para obter mais informações sobre como essa máscara funciona, consulte a Especificação de Referência de Gerenciamento de Energia da Classe de Dispositivo de Rede.
Um padrão de ativação, que inicia bytes PatternOffset desde o início do InformationBuffer. Para obter mais informações sobre padrões de ativação, consulte a Especificação de Referência de Gerenciamento de Energia da Classe de Dispositivo de Rede.
O número de padrões de ativação que o driver de miniporto pode aceitar de um protocolo pode depender da disponibilidade de recursos, como a memória de host que o driver de miniporto alocou para esses padrões ou o armazenamento disponível no adaptador de rede. Se um driver de miniporta não puder adicionar um padrão de ativação devido a recursos insuficientes, o driver de miniporto retornará NDIS_STATUS_RESOURCES em resposta a OID_PNP_ADD_WAKE_UP_PATTERN.
Se um driver de protocolo tentar adicionar um padrão duplicado, o driver de miniporta deverá retornar NDIS_STATUS_INVALID_DATA em resposta a OID_PNP_ADD_WAKE_UP_PATTERN.
Um driver intermediário no qual a borda superior recebe essa solicitação OID deve sempre propagar a solicitação para o driver de miniporto subjacente chamando NdisRequest ou NdisCoRequest.
Requisitos
Versão |
Com suporte no NDIS 6.0 e NDIS 6.1. Para o NDIS 6.20 e posterior, use OID_PM_ADD_WOL_PATTERN . |
parâmetro |
Ntddndis.h (inclua Ndis.h) |