OID_PM_GET_PROTOCOL_OFFLOAD

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 InformationBuffer membro 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 InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_PM_PROTOCOL_OFFLOAD.

Comentários

NDIS 6.20 e drivers de protocolo posteriores usam OID_PM_GET_PROTOCOL_OFFLOAD método OID para recuperar configurações de parâmetro para um descarregamento de protocolo de baixo consumo de energia 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 ProtocolOffloadId membro da estrutura NDIS_PM_PROTOCOL_OFFLOAD quando o NDIS enviou a solicitação OID de OID_PM_ADD_PROTOCOL_OFFLOAD 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 NDIS_PM_PROTOCOL_OFFLOAD correspondente.

NDIS_STATUS_PENDING
O pedido 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. NDIS definir o DADOS. QUERY_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST o tamanho mínimo de buffer necessário.

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

NDIS_STATUS_FAILURE
O pedido foi rejeitado por outros motivos que não os anteriores.

Requerimentos

Ver também

NDIS_PM_PROTOCOL_OFFLOAD

OID_PM_ADD_PROTOCOL_OFFLOAD