OID_SRIOV_VF_VENDOR_DEVICE_ID

  • [アーティクル]

上位ドライバーは、PCI Express (PCIe) 仮想関数 (VF) ネットワーク アダプターの PCI Express (PCIe) デバイス識別子 (DeviceID) とベンダー識別子 (VendorID) を照会する OID_SRIOV_VF_VENDOR_DEVICE_ID のオブジェクト識別子 (OID) メソッド要求を発行します。 この仮想ネットワーク アダプターは、VF に接続されている Hyper-V 子パーティションで公開されます。

上位ドライバーは、ネットワーク アダプターの PCI Express (PCIe) 物理関数 (PF) のミニポート ドライバーにこの OID メソッド要求を発行します。 この OID メソッド要求は、シングルルート I/O 仮想化 (SR-IOV) インターフェイスをサポートする PF ミニポート ドライバーに必要です。

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

解説

この OID メソッド要求を発行する前に、上位ドライバーは NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO 構造体を初期化し、 VFId メンバーを、情報の読み取り元となる VF の識別子に設定する必要があります。

この OID 要求を処理する場合、PF ミニポート ドライバーは、指定した VF に以前に割り当てられているリソースがあることを確認する必要があります。 PF ミニポート ドライバーは、 OID_NIC_SWITCH_ALLOCATE_VF メソッド要求の間に VF のリソースを割り当てます。 指定した VF のリソースが割り当てられていない場合、ドライバーは OID 要求に失敗する必要があります。

詳細については、 仮想関数のPCIベンダーおよびデバイス識別子のクエリ を参照してください。

状態コードを返します

PF ミニポート ドライバーは、OID_SRIOV_VF_VENDOR_DEVICE_IDK の OID メソッド要求の次の状態コードのいずれかを返します：

状態コード 説明

NDIS_STATUS_SUCCESS

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

NDIS_STATUS_NOT_SUPPORTED

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

NDIS_STATUS_INVALID_PARAMETER

NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO 構造体の1つ以上のメンバーに無効な値があります。+

NDIS_STATUS_INVALID_LENGTH

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

NDIS_STATUS_FAILURE

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

要件

バージョン

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

ヘッダー

 Ntddndis.h (Ndis.h を含む)

関連項目

NDIS_OID_REQUEST

NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO

OID_NIC_SWITCH_ALLOCATE_VF