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 構造体の InformationBuffer メンバーには、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の OID メソッド要求中に VF のリソースを割り当てます。 指定した VF のリソースが割り当てられていない場合、ドライバーは OID 要求に失敗する必要があります。
詳細については、「仮想関数 の PCI ベンダーおよびデバイス識別子の照会の」を参照してください。
戻り値の状態コード
PF ミニポート ドライバーは、OID_SRIOV_VF_VENDOR_DEVICE_IDの OID メソッド要求の次の状態コードのいずれかを返します。
| 状態コード | 形容 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求が正常に完了しました。 |
NDIS_STATUS_NOT_SUPPORTED |
PF ミニポート ドライバーは、単一ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートしていないか、インターフェイスの使用が有効になっていません。 |
NDIS_STATUS_INVALID_PARAMETER |
NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO 構造体の 1 つ以上のメンバーに無効な値があります。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーが短すぎます。 NDIS は、データを設定します。METHOD_INFORMATION。BytesNeededNDIS_OID_REQUEST 構造体のメンバーを、必要な最小バッファー サイズに設定します。 |
NDIS_STATUS_FAILURE |
その他の理由で要求が失敗しました。 |
必要条件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |