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 を含む) |