上にあるドライバーまたはユーザー モード アプリケーションは、配列を取得するためにOID_NIC_SWITCH_ENUM_SWITCHESのオブジェクト識別子 (OID) クエリ要求を発行します。 配列内の各要素は、ネットワーク アダプターに作成された NIC スイッチの属性を指定します。
この OID クエリ要求から正常に戻った後、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、次を含むバッファーへのポインターが含まれます。
配列内の要素の数を定義する NDIS_NIC_SWITCH_INFO_ARRAY 構造体。
NDIS_NIC_SWITCH_INFO 構造体の配列。 これらの各構造体には、ネットワーク アダプターで作成された 1 つの NIC スイッチに関する情報が含まれています。
注意 ネットワーク アダプターに NIC スイッチがない場合、ドライバーは、NDIS_NIC_SWITCH_INFO_ARRAY 構造体の NumElements メンバーを 0 に設定し、NDIS_NIC_SWITCH_INFO 構造体は返されません。
備考
上にあるドライバーとユーザー モード アプリケーションは、ネットワーク アダプターに作成された NIC スイッチを列挙するために、OID_NIC_SWITCH_ENUM_SWITCHESの OID クエリ要求を発行します。
注 Windows Server 2012 以降では、単一ルート I/O 仮想化 (SR-IOV) インターフェイスでは、ネットワーク アダプターの既定の NIC スイッチのみがサポートされます。 したがって、返される NDIS_NIC_SWITCH_INFO_ARRAY 構造体は、既定の NIC スイッチの 1 つの 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 は、データを設定します。QUERY_INFORMATION。BytesNeededNDIS_OID_REQUEST 構造体のメンバーを、必要な最小バッファー サイズに設定します。 |
NDIS_STATUS_FAILURE |
その他の理由で要求が失敗しました。 |
必要条件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |