OID_NIC_SWITCH_ENUM_SWITCHES

上部のドライバーまたはユーザー モード アプリケーションは、OID_NIC_SWITCH_ENUM_SWITCHES のオブジェクト識別子 (OID) クエリ要求を発行して、配列を取得します。 配列内の各要素は、ネットワーク アダプターに作成された NIC スイッチの属性を指定します。

NDIS_OID_REQUEST 構造体の InformationBuffer メンバーは、この OID クエリ要求から正常に返された後、次を含むバッファーへのポインターが含まれます。

• 配列内の要素の数を定義する NDIS_NIC_SWITCH_INFO_ARRAY 構造体。

• NDIS_NIC_SWITCH_INFO 構造体の配列。 これらの構造体にはそれぞれ、ネットワーク アダプターで作成された 1 つの NIC スイッチに関する情報が含まれています。

  注 ネットワーク アダプターに NIC スイッチがない場合、ドライバーは、NDIS_NIC_SWITCH_INFO_ARRAY 構造体の NumElements メンバーを 0 に設定し、NDIS_NIC_SWITCH_INFO 構造体は返されません。

解説

上部のドライバーとユーザー モード アプリケーションは、OID_NIC_SWITCH_ENUM_SWITCHES の OID クエリ要求を発行して、ネットワーク アダプターに作成された NIC スイッチを列挙します。

注 Windows Server 2012 以降では、シングル ルート I/O 仮想化 (SR-IOV) インターフェイスは、ネットワーク アダプターの既定の NIC スイッチのみをサポートします。 したがって、返された NDIS_NIC_SWITCH_INFO_ARRAY 構造体は既定の NIC スイッチの単一の NDIS_NIC_SWITCH_INFO 要素を指定する必要があり、この要素は、NDIS_DEFAULT_SWITCH_ID の識別子によって参照されます。

状態コードを返す

NDIS は、ミニポート ドライバーの OID_NIC_SWITCH_ENUM_SWITCHES 要求の OID クエリ要求を処理します。 ドライバーは、この OID 要求を発行しません。

NDIS は、OID_NIC_SWITCH_ENUM_SWITCHES 要求を処理すると、次のいずれかの状態コードを返します。

状態コード	説明
NDIS_STATUS_SUCCESS	OID 要求は正常に完了しました。
NDIS_STATUS_NOT_SUPPORTED	ミニポート ドライバーが SR-IOV インターフェイスをサポートしていないか、インターフェイスの使用が有効になっていません。
NDIS_STATUS_INVALID_PARAMETER	NDIS_NIC_SWITCH_INFO_ARRAY 構造体の 1 つ以上のメンバーに無効な値が含まれています。
NDIS_STATUS_INVALID_LENGTH	情報バッファーが短すぎました。 NDIS sets the NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズを設定します。
NDIS_STATUS_FAILURE	その他の理由で要求に失敗しました。

要件

バージョン	NDIS 6.30 以降でサポートされています。
ヘッダー	Ntddndis.h (Ndis.h を含む)

関連項目

---

NDIS_NIC_SWITCH_INFO

NDIS_NIC_SWITCH_INFO_ARRAY

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_PARAMETERS