Share via

OID_PM_GET_PROTOCOL_OFFLOAD

  • Artigo

Um driver sobreposto emite uma solicitação de método OID de OID_PM_GET_PROTOCOL_OFFLOAD para obter configurações de parâmetro para um descarregamento de protocolo de baixa energia de um adaptador de rede.

O membro InformationBuffer da estrutura NDIS_OID_REQUEST inicialmente contém um ponteiro para um identificador de descarregamento de protocolo ULONG. Após um retorno bem-sucedido da solicitação do método OID, o membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_PM_PROTOCOL_OFFLOAD .

Comentários

Os drivers de protocolo NDIS 6.20 e posteriores usam OID_PM_GET_PROTOCOL_OFFLOAD método OID para recuperar as configurações de parâmetro para um descarregamento de protocolo de baixa potência de um adaptador de rede.

O buffer de informações deve apontar para um identificador de descarregamento de protocolo do tipo ULONG. O NDIS define esse identificador de descarregamento de protocolo no membro ProtocolOffloadId da estrutura NDIS_PM_PROTOCOL_OFFLOAD quando o NDIS enviou o OID_PM_ADD_PROTOCOL_OFFLOAD solicitação OID anterior para o adaptador de rede subjacente.

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

NDIS_STATUS_SUCCESS
Os dados solicitados foram recuperados com êxito. O buffer de informações contém a estrutura de NDIS_PM_PROTOCOL_OFFLOAD correspondente.

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 de solicitação OID do chamador.

NDIS_STATUS_INVALID_PARAMETER
O identificador de descarregamento de protocolo especificado não era válido.

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

NDIS_STATUS_NOT_SUPPORTED
A versão NDIS do driver de miniporta está abaixo da 6.20.

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

Requisitos

Versão

Com suporte no NDIS 6.20 e posterior. Obrigatório para drivers de miniporta. (Consulte a seção Observações.)

Cabeçalho

 Ntddndis.h (inclua Ndis.h)

Confira também

NDIS_PM_PROTOCOL_OFFLOAD

OID_PM_ADD_PROTOCOL_OFFLOAD