OID_SWITCH_NIC_ARRAY

Hyper-V 拡張可能スイッチ拡張機能は、配列を取得する OID_SWITCH_NIC_ARRAY のオブジェクト識別子 (OID) クエリ要求を発行します。 配列内の各要素は、拡張可能スイッチ ポートに関連付けられている仮想ネットワーク アダプターの構成パラメーターを指定します。

OID クエリ要求が正常に完了した場合、 NDIS_OID_REQUEST 構造体の InformationBuffer メンバーにはバッファーへのポインターが含まれます。 このバッファーには、次のデータが含まれています:

  • 配列内の要素の数を定義する NDIS_SWITCH_NIC_ARRAY 構造体。 この構造体は、配列内の最初の要素へのオフセットも指定します。

  • NDIS_SWITCH_NIC_PARAMETERS 構造体の配列。 これらの各構造体には、拡張可能スイッチ ポートに接続されているネットワーク アダプターに関する情報が含まれています。

    ネットワーク アダプターが拡張可能スイッチ ポートに接続されていない場合は、拡張可能スイッチの下位ミニポート エッジは、 NDIS_SWITCH_NIC_ARRAY 構造体の NumElements メンバーを 0 に設定します。 この場合、 NDIS_SWITCH_NIC_PARAMETERS 構造体は返されません。

解説

OID_SWITCH_NIC_ARRAY OID は、Hyper-V 拡張可能スイッチがアクティブ化を完了したときにのみ発行する必要があります。 詳細については、 Hyper-V 拡張可能スイッチ構成のクエリ を参照してください。

返された NDIS_SWITCH_NIC_PARAMETERS 構造体を拡張機能が処理する場合、 NDIS_SWITCH_PORT_PARAMETERS 構造体、例えば、 NicFriendlyName 構造体のメンバーなどの文字列メンバーが NULL で終わるとは想定しないでください。 これらの文字列メンバーのデータタイプは、 IF_COUNTED_STRING 構造体によってタイプ定義されます。 ドライバーは、この構造体の Length メンバーの値から文字列の長さを決定する必要があります。

文字列が null で終わる場合、 Length メンバーに終端の null 文字を含めてはなりません。

状態コードを返します

拡張可能スイッチの下位ミニポート エッジは、OID_SWITCH_NIC_ARRAYの OID クエリ要求を完了し、次のいずれかの状態コードを返します。

状態コード 説明

NDIS_STATUS_SUCCESS

OID 要求は正常に完了しました。

NDIS_STATUS_INVALID_LENGTH

情報バッファの長さは、 NDIS_SWITCH_NIC_ARRAY とその NDIS_SWITCH_NIC_PARAMETERS 要素の配列を返すには短すぎます。 拡張可能スイッチの下位ミニポート エッジは、 NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファーを設定します。

NDIS_STATUS_FAILURE

その他の理由で要求に失敗しました。

要件

バージョン

NDIS 6.30 以降でサポートされています。

ヘッダー

Ntddndis.h (Ndis.h を含む)

関連項目


NDIS_OID_REQUEST

NDIS_SWITCH_NIC_ARRAY

NDIS_SWITCH_NIC_PARAMETERS

Hyper-V 拡張可能スイッチ構成のクエリ