基になるドライバーは、ネットワーク アダプターで指定された NIC スイッチの現在の構成パラメーターを取得するOID_NIC_SWITCH_PARAMETERSのオブジェクト識別子 (OID) メソッド要求を発行します。 NDIS は、ミニポート ドライバーのこれらの OID メソッド要求を処理します。
基になるドライバーは、ネットワーク アダプターで指定された NIC スイッチの構成パラメーターを設定するOID_NIC_SWITCH_PARAMETERSの OID セット要求を発行します。 これらの OID セット要求は、ネットワーク アダプターの PCI Express (PCIe) 物理機能 (PF) のミニポート ドライバーに発行されます。 これらの OID セット要求は、単一ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートする PF ミニポート ドライバーに必要です。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_NIC_SWITCH_PARAMETERS 構造体へのポインターが含まれています。
上にあるドライバーは、OID メソッドの NIC スイッチを指定するか、NDIS_NIC_SWITCH_PARAMETERS 構造体の SwitchId メンバーをスイッチ識別子に設定することによって要求を設定します。 上にあるドライバーは、次のいずれかの方法でスイッチ識別子を取得します。
OID_NIC_SWITCH_ENUM_SWITCHESの以前の OID メソッド要求から。
NicSwitchArray から、NDIS_BIND_PARAMETERS 構造体のメンバー。 NDIS は、ProtocolBindAdapterEx 関数の BindParameters パラメーターで、この構造体へのポインターを渡します。
NicSwitchArray から、NDIS_FILTER_ATTACH_PARAMETERS 構造体のメンバーを します。 NDIS は、FilterAttach 関数の AttachParameters パラメーターで、この構造体へのポインターを渡します。
注 Windows Server 2012 以降では、Windows はネットワーク アダプターの既定の NIC スイッチのみをサポートします。 NDIS_NIC_SWITCH_PARAMETERS 構造体の SwitchId メンバーを NDIS_DEFAULT_SWITCH_ID に設定する必要があります。
備考
基になるドライバーは、次の方法で要求OID_NIC_SWITCH_PARAMETERS問題が発生します。
基になるドライバーは、指定した NIC スイッチの現在のパラメーターを取得するOID_NIC_SWITCH_PARAMETERSの OID メソッド要求を発行します。 詳細については、「NIC スイッチのパラメーターのクエリを実行する」を参照してください。
注 NDIS は、PF ミニポート ドライバーのOID_NIC_SWITCH_PARAMETERSの OID メソッド要求を処理します。
基になるドライバーは、指定した NIC スイッチの現在のパラメーターを変更するOID_NIC_SWITCH_PARAMETERSの OID セット要求を発行します。 詳細については、「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 ミニポート ドライバーは、DATA を設定します。METHOD_INFORMATION。BytesNeeded メンバー (OID メソッド要求の場合) または data 。SET_INFORMATION。BytesNeeded メンバー (OID セット要求の場合) は、必要な最小バッファー サイズに NDIS_OID_REQUEST 構造体。 |
NDIS_STATUS_REINIT_REQUIRED |
PF ミニポート ドライバーには、NIC スイッチに変更を適用するネットワーク アダプターの再初期化が必要です。 |
NDIS_STATUS_FAILURE |
その他の理由で要求が失敗しました。 |
必要条件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |