ネットワーク アダプターでの NIC スイッチの列挙

上のドライバーやユーザー アプリケーションでは、シングルルート I/O 仮想化 (SR-IOV) をサポートするネットワーク アダプターに作成されたすべての NIC スイッチの一覧を取得できます。 ドライバーまたはアプリケーションは、この一覧を取得するOID_NIC_SWITCH_ENUM_SWITCHESのオブジェクト識別子 (OID) クエリリクエストを発行します。

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 構造体は返されません。

注 Windows Server 2012 以降では、SR-IOV インターフェイスは、ネットワーク アダプターの既定の NIC スイッチを１つのみサポートします。 このスイッチは既定の NIC スイッチと呼ばれており、NDIS_DEFAULT_SWITCH_ID識別子で参照します。

NDIS は、ミニポート ドライバーの OID_NIC_SWITCH_ENUM_SWITCHES リクエストを処理します。 NDIS は、次のソースよりインデータの内部キャッシュから情報を返します。

• レジストリで標準化した SR-IOV キーワード設定。 このようなキーワードの詳細については、 「SR-IOV の標準化された INF キーワード」をご覧ください。

• OID_NIC_SWITCH_CREATE_SWITCHとOID_NIC_SWITCH_PARAMETERSの OID リクエスト。

注 NDIS は、NDIS_BIND_PARAMETERSおよびNDIS_FILTER_ATTACH_PARAMETERS構造体の NicSwitchArray メンバー内のスイッチの列挙も提供します。 そのため、この情報を取得するのに、上のプロトコルドライバーとフィルター ドライバー OID_NIC_SWITCH_ENUM_SWITCHESリクエストを発行する必要はありません。