基になるドライバーは、PCI Express (PCIe) 仮想関数 (VF) のリソースを割り当てるためのOID_NIC_SWITCH_ALLOCATE_VFのオブジェクト識別子 (OID) メソッド要求を発行します。 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_NIC_SWITCH_FREE_VF の OID セット要求を発行する必要があります。 上にあるドライバーを停止する前に、ドライバーの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。BytesNeededNDIS_OID_REQUEST 構造体のメンバーを、必要な最小バッファー サイズに設定します。 |
NDIS_STATUS_FAILURE |
その他の理由で要求が失敗しました。 |
必要条件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |