次の方法で共有


OID_NIC_SWITCH_DELETE_VPORT

上部のドライバーは、OID_NIC_SWITCH_DELETE_VPORT のオブジェクト識別子 (OID) セット要求を発行して、ネットワーク アダプターの NIC スイッチに以前に作成された既定以外の仮想ポート (VPort) を削除します。 上部のドライバーは、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 に割り当てられたハードウェアとソフトウェア リソースを解放する必要があります。

詳細については、「仮想ポートの削除」を参照してください。

OID_NIC_SWITCH_DELETE_VPORT の OID 要求によって明示的に削除できるのは、既定以外の VPort のみです。 既定の 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.BytesNeeded メンバー (NDIS_OID_REQUEST 構造体を設定する必要があります。

NDIS_STATUS_FAILURE

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

要件

バージョン

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

ヘッダー

Ntddndis.h (Ndis.h を含む)

関連項目


NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS

NDIS_OID_REQUEST

NdisCloseAdapterEx

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_DELETE_SWITCH