estrutura NDIS_SWITCH_NIC_OID_REQUEST (ntddndis.h)

  • Artigo

A estrutura NDIS_SWITCH_NIC_OID_REQUEST especifica as informações necessárias para encaminhar ou originar solicitações OID.

Sintaxe

typedef struct _NDIS_SWITCH_NIC_OID_REQUEST {
  NDIS_OBJECT_HEADER    Header;
  ULONG                 Flags;
  NDIS_SWITCH_PORT_ID   SourcePortId;
  NDIS_SWITCH_NIC_INDEX SourceNicIndex;
  NDIS_SWITCH_PORT_ID   DestinationPortId;
  NDIS_SWITCH_NIC_INDEX DestinationNicIndex;
  PNDIS_OID_REQUEST     OidRequest;
} NDIS_SWITCH_NIC_OID_REQUEST, *PNDIS_SWITCH_NIC_OID_REQUEST;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_SWITCH_NIC_OID_REQUEST . Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .

O membro Tipo de Cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SWITCH_NIC_OID_REQUEST , o membro Revision de Header deve ser definido como o seguinte valor:

NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Esse membro é reservado para o NDIS.

SourcePortId

Um valor NDIS_SWITCH_PORT_ID que contém o identificador exclusivo da porta de comutador extensível do Hyper-V para a qual a solicitação OID foi originalmente emitida.

SourceNicIndex

Um valor NDIS_SWITCH_NIC_INDEX que especifica o índice do adaptador de rede de origem que está conectado à porta de comutador extensível de origem especificada pelo membro SourcePortId .

DestinationPortId

Um valor NDIS_SWITCH_PORT_ID que contém o identificador exclusivo da porta de comutador extensível para a qual a solicitação OID deve ser encaminhada.

DestinationNicIndex

Um valor NDIS_SWITCH_NIC_INDEX que especifica o índice do adaptador de rede de destino que está conectado à porta de comutador extensível especificada pelo membro DestinationPortId .

OidRequest

Um ponteiro para uma estrutura NDIS_OID_REQUEST . Essa estrutura contém os dados da solicitação OID que serão encaminhados para o driver de miniporto do adaptador de rede especificado pelos membros DestinationPortId e DestinationNicIndex .

Comentários

A estrutura NDIS_SWITCH_NIC_OID_REQUEST é usada em solicitações de método OID de OID_SWITCH_NIC_REQUEST.

Uma extensão pode encaminhar ou originar solicitações de OID para adaptadores de rede física subjacentes na pilha extensível do driver de comutador. Isso permite que uma extensão faça o seguinte:

  • Gerencie a configuração de descarregamentos de hardware em um adaptador físico subjacente para as seguintes tecnologias de descarregamento:
    • IPsec (internet protocol security).
    • VMQ (fila de máquina virtualizada).
    • SR-IOV (Virtualização de E/S de raiz única).
  • Consulte a configuração de um adaptador de rede física subjacente emitindo OIDs NDIS padrão. Por exemplo, a extensão pode emitir uma solicitação de consulta OID de OID_802_3_CURRENT_ADDRESS para obter o endereço MAC (controle de acesso à mídia) atual do adaptador.
Para obter diretrizes sobre como emitir solicitações de OID para adaptadores físicos subjacentes, consulte Gerenciando solicitações de OID para adaptadores de rede física.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.30 e posterior.
Cabeçalho ntddndis.h (inclua Ndis.h)

Confira também

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

OID_SWITCH_NIC_REQUEST