OID_NIC_SWITCH_DELETE_VPORT
上にあるドライバーは、ネットワーク アダプターの NIC スイッチで以前に作成された既定以外の仮想ポート (VPort) を削除するOID_NIC_SWITCH_DELETE_VPORTのオブジェクト識別子 (OID) セット要求を発行します。 上にあるドライバーは、OID_NIC_SWITCH_CREATE_VPORTの OID メソッド要求を発行することによってのみ、以前に作成した VPort を削除できます。
基になるドライバーは、ネットワーク アダプターの PCIe 物理機能 (PF) のミニポート ドライバーにこの OID セット要求を発行します。 この OID セット要求は、単一ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートする PF ミニポート ドライバーに必要です。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS 構造体へのポインターが含まれています。
備考
プロトコルやフィルター ドライバーなどの上にあるドライバーは、以前に作成した既定以外の VPort のみを削除できます。 基になるドライバーは、OID_NIC_SWITCH_CREATE_VPORTの OID メソッド要求を発行することによって VPort を作成します。
PF ミニポート ドライバーは、OID_NIC_SWITCH_DELETE_VPORTの OID 要求を受信すると、ドライバーは、指定された VPort に割り当てられたハードウェアとソフトウェア リソースを解放する必要があります。
詳細については、「仮想ポートの削除」を参照してください。
注 既定以外の VPort は、OID_NIC_SWITCH_DELETE_VPORTの OID 要求を通じて明示的に削除できます。 既定の VPort は、PF ミニポート ドライバーが既定の NIC スイッチを削除するときに暗黙的に削除されます。 詳細については、「NIC スイッチ の削除」を参照してください。
戻り値の状態コード
PF ミニポート ドライバーは、OID_NIC_SWITCH_DELETE_VPORTの OID セット要求の次の状態コードのいずれかを返します。
| 状態コード | 形容 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求が正常に完了しました。 |
NDIS_STATUS_NOT_SUPPORTED |
PF ミニポート ドライバーは、単一ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートしていないか、インターフェイスの使用が有効になっていません。 |
NDIS_STATUS_INVALID_PARAMETER |
NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS 構造体の 1 つ以上のメンバーに無効な値があります。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーの長さが sizeof(NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS) 未満です。 PF ミニポート ドライバーは、DATA を設定する必要があります。SET_INFORMATION。BytesNeededNDIS_OID_REQUEST 構造体のメンバーを、必要な最小バッファー サイズに設定します。 |
NDIS_STATUS_FAILURE |
その他の理由で要求が失敗しました。 |
必要条件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |
関連項目
NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS
NdisCloseAdapterExの