NDIS_SWITCH_NIC_OID_REQUEST 構造体 (ntddndis.h)

[アーティクル]
08/07/2023

NDIS_SWITCH_NIC_OID_REQUEST構造体は、OID 要求を転送または発信するために必要な情報を指定します。

構文

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;

メンバー

Header

NDIS_SWITCH_NIC_OID_REQUEST構造体の型、リビジョン、およびサイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

Header の Type メンバーは、NDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_SWITCH_NIC_OID_REQUEST構造体のバージョンを指定するには、Header の Revision メンバーを次の値に設定する必要があります。

NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1

NDIS 6.30 以降の元のバージョン。

[サイズ] メンバーを [NDIS_SIZEOF_NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1] に設定します。

Flags

フラグのビットごとの OR を含む ULONG 値。このメンバーは NDIS 用に予約されています。

SourcePortId

OID 要求が最初に発行された Hyper-V 拡張可能スイッチポートの一意識別子を含むNDIS_SWITCH_PORT_ID値。

SourceNicIndex

SourcePortId メンバーによって指定されたソース拡張可能スイッチポートに接続されているソースネットワークアダプターのインデックスを指定するNDIS_SWITCH_NIC_INDEX値。

DestinationPortId

OID 要求の転送先となる拡張可能スイッチポートの一意識別子を含むNDIS_SWITCH_PORT_ID値。

DestinationNicIndex

DestinationPortId メンバーによって指定された拡張可能スイッチポートに接続されている宛先ネットワークアダプターのインデックスを指定するNDIS_SWITCH_NIC_INDEX値。

OidRequest

NDIS_OID_REQUEST構造体へのポインター。この構造体には、 DestinationPortId メンバーと DestinationNicIndex メンバーによって指定されたネットワークアダプターのミニポートドライバーに転送される OID 要求のデータが含まれています。

注釈

NDIS_SWITCH_NIC_OID_REQUEST構造体は、OID_SWITCH_NIC_REQUESTの OID メソッド要求で使用されます。

拡張機能は、拡張可能スイッチドライバースタック内の基になる物理ネットワークアダプターに OID 要求を転送または発信できます。これにより、拡張機能で次の操作を実行できます。

次のオフロードテクノロジの基になる物理アダプターでのハードウェアオフロードの構成を管理します。
- インターネットプロトコルセキュリティ (IPsec)。
- 仮想化されたマシンキュー (VMQ)。
- シングルルート I/O 仮想化 (SR-IOV)。
標準の NDIS OID を発行して、基になる物理ネットワークアダプターの構成を照会します。たとえば、拡張機能は、アダプターの現在のメディアアクセス制御 (MAC) アドレスを取得する OID_802_3_CURRENT_ADDRESS の OID クエリ要求を発行できます。

基になる物理アダプターに OID 要求を発行する方法のガイドラインについては、「物理ネットワークアダプターへの OID 要求の管理」を参照してください。