OID_NIC_SWITCH_ALLOCATE_VF

  • [アーティクル]

上部のドライバーは、OID_NIC_SWITCH_ALLOCATE_VF のオブジェクト識別子 (OID) メソッド要求を発行して、PCI Express (PCIe) 仮想関数 (VF) のリソースを割り当てます。 VF は、単一ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートするネットワーク アダプターで公開されます。

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

NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_NIC_SWITCH_VF_PARAMETERS 構造体を指すポインターが含まれています。

解説

PF ミニポート ドライバーは、ドライバーが OID_NIC_SWITCH_ALLOCATE_VF のオブジェクト識別子 (OID) メソッド要求を処理するとき、VF にソフトウェア リソースを割り当てます。 ハードウェア リソースが VF に割り当てられている場合でも、PF ミニポート ドライバーが正常に OID_NIC_SWITCH_ALLOCATE_VF を完了するまで非運用状態と見なされます。

VF リソースを割り当てる方法の詳細については、「仮想関数へのリソースの割り当て」を参照してください。

注 上部のドライバーが VF のリソース割り当てを要求した後、そのドライバーは、同じ VF のリソースの解放を要求できる唯一のコンポーネントです。 上部のドライバーは、VF リソースを解放する OID セット要求 OID_NIC_SWITCH_FREE_VF を発行する必要があります。 上部のドライバーを停止する前に、ドライバーの OID_NIC_SWITCH_ALLOCATE_VF 要求によって割り当てられた各 VF のリソースを解放する必要があります。

状態コードを返す

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

状態コード 説明

NDIS_STATUS_SUCCESS

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

NDIS_STATUS_NOT_SUPPORTED

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

NDIS_STATUS_INVALID_PARAMETER

NDIS_NIC_SWITCH_VF_PARAMETERS 構造体の 1 つ以上のメンバーに無効な値が含まれています。

NDIS_STATUS_INVALID_LENGTH

情報バッファーの長さが sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS) 未満です。 PF ミニポートは、 DATA.METHOD_INFORMATION.BytesNeeded メンバー (NDIS_OID_REQUEST 構造体を設定する必要があります。

NDIS_STATUS_FAILURE

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

要件

バージョン

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

ヘッダー

 Ntddndis.h (Ndis.h を含む)

関連項目

NDIS_MAKE_RID

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT

NDIS_NIC_SWITCH_VF_PARAMETERS

OID_NIC_SWITCH_FREE_VF