OID_PNP_ADD_WAKE_UP_PATTERN
O OID OID_PNP_ADD_WAKE_UP_PATTERN é 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 miniporto (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 InformationBuffer membro 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 bytes correspondentes no padrão. A máscara começa com o primeiro byte do pacote. A máscara segue imediatamente a estrutura de NDIS_PM_PACKET_PATTERN no InformationBuffer. Para obter mais informações sobre como essa máscara funciona, consulte a especificação Network Device Class Power Management Reference.
Um padrão de ativação, que começa PatternOffset bytes 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 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 do host que o driver de miniporto alocou para esses padrões ou o armazenamento disponível no adaptador de rede. Se um driver de miniporto 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 miniporto 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 em vez disso. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |