NDIS は、ネットワーク アダプターから NIC スイッチを削除するOID_NIC_SWITCH_DELETE_SWITCHのオブジェクト識別子 (OID) セット要求を発行します。
NDIS は、ネットワーク アダプターの PCI Express (PCIe) 物理機能 (PF) のミニポート ドライバーにこの OID セット要求を発行します。 この OID セット要求は、単一ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートする PF ミニポート ドライバーに必要です。
プロトコルドライバーやフィルター ドライバーなど、 上にあるドライバーは、この OID メソッド要求を PF ミニポート ドライバーに発行できないことに注意してください。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS 構造体へのポインターが含まれています。
備考
OID_NIC_SWITCH_DELETE_SWITCHの OID セット要求は、OID_NIC_SWITCH_CREATE_SWITCHの OID メソッド要求によって以前に作成された NIC スイッチを削除します。
OID_NIC_SWITCH_DELETE_SWITCHの OID メソッド要求を受信すると、PF ミニポート ドライバーは、次の操作を行う必要があります。
PF ミニポート ドライバーは、NIC スイッチの静的な作成と構成をサポートしている場合は、指定した NIC スイッチに関連付けられているソフトウェア リソースを解放する必要があります。 ただし、ドライバーは、ミニポートHaltExが呼び出された場合にのみ、NIC スイッチのハードウェア リソース解放できます。
静的 NIC スイッチの作成の詳細については、「NIC スイッチの静的作成」を参照してください。
PF ミニポート ドライバーが NIC スイッチの動的な作成と構成をサポートしている場合は、指定された NIC スイッチに関連付けられているハードウェアおよびソフトウェア リソースを解放する必要があります。
動的 NIC スイッチの作成の詳細については、「NIC スイッチの動的作成」を参照してください。
PF ミニポート ドライバーは、動的な作成をサポートし、すべての NIC スイッチが削除されている場合、ドライバーは、NdisMEnableVirtualizationを呼び出すことによって、アダプターの仮想化を無効にする必要があります。 仮想化を無効にするには、ネットワーク アダプターで EnableVirtualization パラメーターを FALSE に設定し、NumVFs パラメーターを 0 に設定する必要があります。
NdisMEnableVirtualization は、NumVFs メンバーをクリアし、ネットワーク アダプターの PF の PCI 構成空間にある SR-IOV 拡張機能構造の VF Enable ビットをクリアします。
注 PF ミニポート ドライバーが NIC スイッチの静的な作成と構成をサポートしている場合は、ミニポートHaltExが呼び出されたときに NdisMEnableVirtualization のみを呼び出す必要があります。
詳細については、「NIC スイッチ の削除」を参照してください。
戻り値の状態コード
ミニポート ドライバーの ミニポート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_DELETE_SWITCH_PARAMETERS 構造体の 1 つ以上のメンバーに無効な値があります。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーが小さすぎます。 NDIS は、データを設定します。SET_INFORMATION。BytesNeededNDIS_OID_REQUEST 構造体のメンバーを、必要な最小バッファー サイズに設定します。 |
必要条件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |