OID_NIC_SWITCH_PARAMETERS
上部のドライバーは、OID_NIC_SWITCH_PARAMETERS のオブジェクト識別子 (OID) メソッド要求を発行して、ネットワーク アダプターの指定された NIC スイッチの現在の構成パラメーターを取得します。 NDIS は、ミニポート ドライバーのこれらの OID メソッド要求を処理します。
上部のドライバーは、OID_NIC_SWITCH_PARAMETERS の OID セット要求を発行して、ネットワーク アダプターの指定された NIC スイッチの構成パラメーターを設定します。 これらの OID セット要求は、ネットワーク アダプターの PCI Express (PCIe) 物理機能 (PF) のミニポート ドライバーに発行されます。 これらの OID セット要求は、シングルルート I/O 仮想化 (SR-IOV) インターフェイスをサポートする PF ミニポートドライバーに必要なものです。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_NIC_SWITCH_PARAMETERS 構造体を指すポインターが含まれています。
上部のドライバーは、NDIS_NIC_SWITCH_PARAMETERS 構造体の SwitchId メンバーをスイッチ識別子に設定して、OID メソッドまたはセット要求に対して NIC スイッチを指定します。 上部のドライバーは、次のいずれかの方法でスイッチ識別子を取得します。
OID_NIC_SWITCH_ENUM_SWITCHES の以前の OID メソッド要求から。
NDIS_BIND_PARAMETERS 構造体の NicSwitchArray メンバーから。 NDIS は、ProtocolBindAdapterEx 関数の BindParameters パラメーターでこの構造体へのポインターを渡します。
NDIS_FILTER_ATTACH_PARAMETERS 構造体の NicSwitchArray メンバーから。 NDIS は、FilterAttach 関数の AttachParameters パラメーターで、この構造体へのポインターを渡します。
注 Windows Server 2012 以降では、Windows がサポートしているのはネットワーク アダプターの既定の NIC スイッチのみです。 NDIS_NIC_SWITCH_PARAMETERS 構造体の SwitchId メンバーを NDIS_DEFAULT_SWITCH_ID に設定する必要があります。
解説
上部のドライバーは、次の方法で OID_NIC_SWITCH_PARAMETERS 要求を発行します。
上部のドライバーは、OID_NIC_SWITCH_PARAMETERS の OID メソッド要求を発行して、指定した NIC スイッチの現在のパラメーターを取得します。 詳細については、「NIC スイッチのパラメーターに対するクエリの実行」を参照してください。
注 NDIS は、PF ミニポート ドライバーに対する OID_NIC_SWITCH_PARAMETERS の OID メソッド要求を処理します。
上部のドライバーは、OID_NIC_SWITCH_PARAMETERS の OID セット要求を発行して、指定した NIC スイッチの現在のパラメーターを変更します。 詳細については、「NIC スイッチのパラメーターの設定」を参照してください。
注 PF ミニポート ドライバーは、OID_NIC_SWITCH_PARAMETERS の OID セット要求を処理します。
状態コードを返す
NDIS または PF ミニポート ドライバーは、OID_NIC_SWITCH_PARAMETERS のセットまたはメソッド OID 要求に対して次の状態コードを返します。
| 状態コード | 説明 |
|---|---|
NDIS_STATUS_SUCCESS |
要求は正常に完了しました。 InformationBuffer は NDIS_NIC_SWITCH_CAPABILITIES 構造体を指します。 |
NDIS_STATUS_NOT_SUPPORTED |
PF ミニポート ドライバーは、シングル ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートしていないか、インターフェイスを使用できません。 |
NDIS_STATUS_INVALID_PARAMETER |
NDIS_NIC_SWITCH_PARAMETERS 構造体の 1 つ以上のメンバーに無効な値が含まれています。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーが短すぎました。 NDIS または PF ミニポート ドライバーは、NDIS_OID_REQUEST 構造体の DATA.METHOD_INFORMATION.BytesNeeded メンバー (OID メソッド要求に対して) または DATA.SET_INFORMATION.BytesNeeded メンバー (OID セット要求に対して) を要求された最小バッファー サイズに設定します。 |
NDIS_STATUS_REINIT_REQUIRED |
PF ミニポート ドライバーでは、ネットワーク アダプターを再初期化して、NIC スイッチに変更を適用する必要があります。 |
NDIS_STATUS_FAILURE |
その他の理由で要求に失敗しました。 |
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |