OID_NIC_SWITCH_HARDWARE_CAPABILITIES

上部のドライバーは、OID_NIC_SWITCH_HARDWARE_CAPABILITIES のオブジェクト識別子 (OID) クエリ要求を発行して、ネットワーク アダプターの NIC スイッチのハードウェア機能を取得します。

OID クエリ要求から正常に返されると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_NIC_SWITCH_CAPABILITIES 構造体へのポインターが含まれています。

解説

NDIS_NIC_SWITCH_CAPABILITIES 構造体には、ネットワーク アダプターの NIC スイッチのハードウェア機能に関する情報が含まれています。 これらの機能には、INF ファイルの設定または [詳細] プロパティページによって現在無効にされているハードウェア機能を含めることができます。

注 指定した NIC スイッチのすべての機能は、機能が有効か無効かに関係なく、OID_NIC_SWITCH_HARDWARE_CAPABILITIES の OID クエリ要求を通じて返されます。

NDIS 6.30 以降、ミニポート ドライバーは MiniportInitializeEx 機能が呼び出されたときに、NIC スイッチ ハードウェア機能を提供します。 ドライバーは、NIC スイッチのハードウェア機能を使用して NDIS_NIC_SWITCH_CAPABILITIES構造体を初期化し、NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 構造体の HardwareNicSwitchCapabilities メンバーを NDIS_NIC_SWITCH_CAPABILITIES 構造体へのポインターに設定します。 次に、ミニポート ドライバーは NdisMSetMiniportAttributes 関数を呼び出し、 MiniportAttributes パラメーターを NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 構造体へのポインターに設定します。

注 NDIS 6.30 以降では、シングル ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートするミニポート ドライバーは、NIC スイッチのハードウェア機能を登録する必要があります。 ドライバーは、NdisMSetMiniportAttributes を呼び出すことによって、これらの機能を登録します。

状態コードを返す

NDIS は、ミニポート ドライバーに対する OID_NIC_SWITCH_HARDWARE_CAPABILITIES 要求の OID クエリ要求を処理し、次のいずれかの状態コードを返します。

状態コード	説明
NDIS_STATUS_SUCCESS	要求は正常に完了しました。 InformationBuffer は NDIS_NIC_SWITCH_CAPABILITIES 構造体を指します。
NDIS_STATUS_NOT_SUPPORTED	ミニポート ドライバーがシングル ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートしていないか、インターフェイスの使用が有効になっていません。
NDIS_STATUS_INVALID_LENGTH	情報バッファーの長さが sizeof(NDIS_NIC_SWITCH_CAPABILITIES) 未満です。 NDIS sets the NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズを設定します。
NDIS_STATUS_FAILURE	その他の理由で要求に失敗しました。

要件

バージョン	NDIS 6.20 以降でサポートされています。
ヘッダー	Ntddndis.h (Ndis.h を含む)

関連項目

NDIS_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_OID_REQUEST