Partilhar via


OID_PM_PROTOCOL_OFFLOAD_LIST

Como uma consulta, os drivers sobrepostos podem usar o OID_PM_PROTOCOL_OFFLOAD_LIST OID para enumerar os descarregamentos de protocolo definidos em um adaptador de rede subjacente. Após um retorno bem-sucedido da solicitação de consulta OID, o InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma lista de estruturas NDIS_PM_PROTOCOL_OFFLOAD que descrevem os descarregamentos de protocolo atualmente ativos.

Comentários

O NDIS lida com a consulta de drivers de miniporta. Os drivers NDIS podem usar o OID_PM_PROTOCOL_OFFLOAD_LIST OID para obter uma lista de descarregamentos de protocolo definidos em um adaptador de rede subjacente.

Para cada estrutura de NDIS_PM_PROTOCOL_OFFLOAD na lista, o NDIS define o membro NextProtocolOffloadOffset para o deslocamento do 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_PROTOCOL_OFFLOAD na lista. O deslocamento no NextProtocolOffloadOffset membro da última estrutura da lista é zero.

Se não houver descarregamentos de protocolo definidos no adaptador de rede, o NDIS definirá o DATA. QUERY_INFORMATION. BytesWritten membro da estrutura NDIS_OID_REQUEST a zero e retorna NDIS_STATUS_SUCCESS. Os dados dentro do DATA. QUERY_INFORMATION. InformationBuffer membro 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 descarregamentos de protocolo, se houver.

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_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_FAILURE
O pedido foi rejeitado por outros motivos que não os anteriores.

Requerimentos

Versão

Suportado no NDIS 6.20 e posterior. Não solicitado para drivers de miniporta. (Ver secção Observações.)

Cabeçalho

Ntddndis.h (inclui Ndis.h)

Ver também

NDIS_OID_REQUEST

NDIS_PM_PROTOCOL_OFFLOAD