OID_SRIOV_VF_SERIAL_NUMBER

上位ドライバーは、PCI Express (PCIe) 仮想関数 (VF) ネットワーク アダプターのシリアル番号を定義する OID_SRIOV_VF_SERIAL_NUMBER のオブジェクト識別子 (OID) クエリ要求を発行します。 この仮想ネットワーク アダプターは、VF が接続されている Hyper-V 子パーティションのゲスト オペレーティング システムで公開されます。

この NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには NDIS_SRIOV_VF_INVALIDATE_CONFIG_BLOCK_INFO 構造体へのポインターが含まれています。

解説

上位ドライバーは、シリアル番号を使用して、VF ネットワーク アダプターを物理ネットワーク アダプター上の VF のインスタンスにマップします。 シリアル番号は、 OID_NIC_SWITCH_ALLOCATE_VF OID セット要求を通じて割り当てられる前に、仮想化スタックによって生成されます。

状態コードを返します

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

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

状態コード 説明

NDIS_STATUS_SUCCESS

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

NDIS_STATUS_NOT_SUPPORTED

ミニポート ドライバーがシングル ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートしていないか、インターフェイスの使用が有効になっていません。

NDIS_STATUS_INVALID_LENGTH

情報バッファーが短すぎました。 NDIS は、 NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファサイズを設定します。

NDIS_STATUS_FAILURE

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

要件

バージョン

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

ヘッダー

Ntddndis.h (Ndis.h を含む)

関連項目


NDIS_OID_REQUEST

NDIS_SRIOV_VF_SERIAL_NUMBER_INFO

OID_NIC_SWITCH_ALLOCATE_VF