基になるドライバーは、ネットワーク アダプターの PCI Express (PCIe) 仮想関数 (VF) のリソースを解放するOID_NIC_SWITCH_FREE_VFのオブジェクト識別子 (OID) セット要求を発行します。
基になるドライバーは、ネットワーク アダプターの PCIe 物理機能 (PF) のミニポート ドライバーにこの OID セット要求を発行します。 この OID セット要求は、単一ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートする PF ミニポート ドライバーに必要です。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_NIC_SWITCH_FREE_VF_PARAMETERS 構造体へのポインターが含まれています。
上にあるドライバーは、この構造体の VFId メンバーを介して解放する VF の識別子を指定します。 ドライバーは、OID_NIC_SWITCH_ALLOCATE_VFの以前の OID メソッド要求からこの識別子を取得しました。
備考
基になるドライバーは、VF のリソースを解放するOID_NIC_SWITCH_FREE_VFの OID セット要求を発行します。 これらのリソースは以前、OID_NIC_SWITCH_ALLOCATE_VFの OID メソッド要求を通じて割り当てられました。
VF リソースを解放する方法の詳細については、「仮想関数 のリソース解放する」を参照してください。
注 上にあるドライバーが VF のリソース割り当てを要求すると、そのドライバーは、同じ VF のリソースの解放を要求できる唯一のコンポーネントです。 基になるドライバーは、VF リソースを解放するOID_NIC_SWITCH_FREE_VFの OID セット要求を発行する必要があります。 上にあるドライバーを停止する前に、ドライバーの OID_NIC_SWITCH_ALLOCATE_VF 要求によって割り当てられた各 VF のリソースを解放する必要があります。
戻り値の状態コード
ミニポート ドライバーの ミニポートOidRequest 関数は、この要求に対して次のいずれかの値を返します。
| 用語 | 形容 |
|---|---|
NDIS_STATUS_SUCCESS |
ミニポート ドライバーが要求を正常に完了しました。 |
NDIS_STATUS_PENDING |
ミニポート ドライバーは、非同期的に要求を完了します。 ミニポート ドライバーは、すべての処理を完了した後、NdisMOidRequestComplete 関数を呼び出して要求を成功させる必要があります、状態 パラメーターの NDIS_STATUS_SUCCESS を渡します。 |
NDIS_STATUS_NOT_ACCEPTED |
ミニポート ドライバーがリセット中です。 |
NDIS_STATUS_REQUEST_ABORTED |
ミニポート ドライバーが要求の処理を停止しました。 たとえば、NDIS は、ミニポートResetEx 関数を呼び出しました。 |
NDIS は、この要求の次のいずれかの状態コードを返します。
| 用語 | 形容 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求が正常に完了しました。 |
NDIS_STATUS_NOT_SUPPORTED |
PF ミニポート ドライバーは、SR-IOV インターフェイスをサポートしていないか、インターフェイスの使用が有効になっていません。 |
NDIS_STATUS_FILE_NOT_FOUND |
NDIS_NIC_SWITCH_FREE_VF_PARAMETERS 構造体の 1 つ以上のメンバーに無効な値があります。 たとえば、VFId メンバーは、割り当てられていない、または削除されていない VPort を持つ VF を指定できます。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーが小さすぎます。 NDIS は、データを設定します。SET_INFORMATION。BytesNeededNDIS_OID_REQUEST 構造体のメンバーを、必要な最小バッファー サイズに設定します。 |
必要条件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |
関連項目
NDIS_NIC_SWITCH_FREE_VF_PARAMETERS
NdisCloseAdapterExの