Compartilhar via


OID_PM_WOL_PATTERN_LIST

Como uma consulta, drivers sobrepostos podem usar o OID OID_PM_WOL_PATTERN_LIST para enumerar a ativação em padrões lan definidos em um adaptador de rede subjacente. Após um retorno bem-sucedido da consulta, o InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma lista de estruturas de NDIS_PM_WOL_PATTERN que descrevem os padrões WOL adicionados no momento.

Observações

O NDIS manipula a consulta para drivers de miniport. Os drivers NDIS podem usar o OID OID_PM_WOL_PATTERN_LIST para obter uma lista de ativação nos padrões de LAN definidos em um adaptador de rede subjacente.

Para cada estrutura NDIS_PM_WOL_PATTERN na lista, o NDIS define o membro NextWoLPatternOffset para o deslocamento desde o início do buffer de informações OID (ou seja, o início do buffer para o qual o InformationBuffer membro da estrutura NDIS_OID_REQUEST aponta) para o início da próxima estrutura NDIS_PM_WOL_PATTERN na lista. O deslocamento no NextWoLPatternOffset membro da última estrutura da lista é zero.

Para deslocamentos em uma estrutura NDIS_PM_WOL_PATTERN diferente de NextWoLPatternOffset (por exemplo, NameBufferOffset), o NDIS fornece deslocamentos relativos ao início de cada estrutura NDIS_PM_WOL_PATTERN.

Se não houver padrões WOL definidos no adaptador de rede, o NDIS definirá o DATA. QUERY_INFORMATION. BytesWritten membro da estrutura NDIS_OID_REQUEST como zero e retorna NDIS_STATUS_SUCCESS para a solicitação. Os dados no DATA. QUERY_INFORMATION. O membro do InformationBuffer não é modificado pelo NDIS.

O NDIS retorna um dos seguintes códigos de status para a solicitação:

NDIS_STATUS_SUCCESS
A solicitação foi concluída com êxito. O InformationBuffer contém um ponteiro para uma lista de padrões WOL, se houver.

NDIS_STATUS_PENDING
A solicitação está pendente de conclusão. O código de status final e os resultados serão passados para o manipulador de conclusão da solicitação OID do chamador.

NDIS_STATUS_BUFFER_TOO_SHORT
O buffer de informações era muito curto. O NDIS define os dados de . QUERY_INFORMATION. BytesNeededed membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.

NDIS_STATUS_FAILURE
A solicitação falhou por motivos diferentes dos motivos anteriores.

Requisitos

Versão

Com suporte no NDIS 6.20 e posterior. Não solicitado para drivers de miniporto. (Consulte a seção Comentários.)

Cabeçalho

Ntddndis.h (inclua Ndis.h)

Consulte também

NDIS_OID_REQUEST

NDIS_PM_WOL_PATTERN

OID_PM_ADD_WOL_PATTERN

OID_PM_REMOVE_WOL_PATTERN

OID_PNP_WAKE_UP_PATTERN_LIST