次の方法で共有


列挙キーワード

NDIS 6.0 以降のバージョンの NDIS は、ネットワーク デバイスのミニポート ドライバー用に標準化された列挙キーワードを提供します。 列挙キーワード は、メニューのリストとして表示される値と関連付けられます。

次に示すのは、列挙キーワード の INF ファイル定義の例です。

HKR, Ndi\params\<SubkeyName>, ParamDesc, 0, "%<SubkeyName>%"
HKR, Ndi\params\<SubkeyName>, Type, 0, "enum"
HKR, Ndi\params\<SubkeyName>, Default, 0, "3"
HKR, Ndi\params\<SubkeyName>, Optional, 0, "0"
HKR, Ndi\params\<SubkeyName>\enum, "0", 0, "%Disabled%"
HKR, Ndi\params\<SubkeyName>\enum, "1", 0, "%Tx Enabled%"
HKR, Ndi\params\<SubkeyName>\enum, "2", 0, "%Rx Enabled%"
HKR, Ndi\params\<SubkeyName>\enum, "3", 0, "%Rx & Tx Enabled%"

一般的な列挙キーワードは次のとおりです。

*SpeedDuplex
デバイスがサポートする速度とデュプレックスの設定。 デバイス INF ファイルに一覧表示されるのは、関連付けられているデバイスでサポートされている設定のみです。 つまり、全二重モードのみをサポートできるイーサネット 10/100 デバイスの場合、ギガビット以上の速度または半二重の設定は、関連する INF ファイルに一覧表示してはいけません。

列挙値が 0 ~ 10 で現状定義されていない速度値は、Mbps で直接数値として設定できます。 直接値は、少なくとも 1,000 Mbps (1 Gbps) 以上でなければなりません。 次に示すのは、速度を直接指定するいくつかの例です。

速度/デュプレックス 値 結果の速度
1,000 1 Gbps
10,000 10 Gbps
25,000 25 Gbps
50,000 50 Gbps
100,000 100 Gbps

*FlowControl
デバイスが送信パスや受信パスのフロー制御を有効または無効にする機能。

注: 現在、イーサネット デバイスではフロー制御がサポートされ、LAN 用 Windows 8 のインボックス ドライバーでは、既定でフロー制御が有効になっています。 カーネル デバッガーがこれらのいずれかの LAN アダプターに接続すると、NIC はフロー制御の一時停止フレームをネットワークにプッシュし始めます。 ネットワーク スイッチのほとんどは、同じハブに接続されている他のすべてのコンピューターのネットワークを一時停止して対応します。 これは一般的な開発シナリオで、エンド ユーザー エクスペリエンスは好ましくないため診断が困難です。

注: クライアントとサーバーの既定値は同じではありません。以下の既定値の表を参照ください。

このため、Windows 8 以降では、NDIS は、コンピューターでデバッグが有効になっているときに (例:コマンド ラインで bcdedit /set debug on と入力 ) フロー制御を自動的に 無効にします。 カーネル デバッグが有効で、ミニポートが NdisReadConfiguration を呼び出し、キーワード パラメーターの "*FlowControl" を渡すと、NDIS は構成された値をオーバーライドし、0 を返します。

デバッグ中にフロー制御を有効にする必要がある場合、NDIS は、AllowFlowControlUnderDebugger レジストリ値を提供してこれを行えるようにします。 AllowFlowControlUnderDebugger レジストリ値は、NDIS がフロー制御の無効化を防ぎ、NIC が構成された動作を維持できるようにします。 これは、次のレジストリ キーの下にあります。

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\NTDS\Parameters

このレジストリ値を 0x00000001 に設定します。

存在しない場合は、AllowFlowControlUnderDebugger という名前の値とREG_DWORD型を使用して値を作成し、0x00000001に設定できます。

*PriorityVLANTag
デバイスがパケット優先度と仮想 LAN (VLAN) の 802.1Q タグを挿入する機能を有効または無効にしたかどうかを示す値。 このキーワードでは、デバイスがパケット優先度タグまたは VLAN タグを有効または無効にしているかどうかは示されません。 代わりに、次の内容について説明します。

  • 送信操作中にデバイスが 802.1Q タグを挿入するかどうか
  • 802.1Q タグ情報が NET_BUFFER_LIST 帯域外 (OOB) 情報で使用可能かどうか
  • デバイスが受信操作中に 802.1Q タグを OOB にコピーするか

ミニポート ドライバーは、*PriorityVLANTag 設定に関係なく、すべての受信パケットから 802.1Q ヘッダーを削除する必要があります。 802.1Q ヘッダーがパケットに残っている場合、他のドライバーがパケットを正しく解析できないことがあります。

Rx フラグが受信パスで有効になっている場合、ミニポート ドライバーで、OOB に削除された 802.1Q ヘッダーをコピーしてください。

それ以外で、Rx フラグが無効になっている場合、ミニポート ドライバーは、OOB に削除された 802.1Q ヘッダーをコピーしないでください。

送信パスで Tx フラグが有効になっている場合、ミニポート ドライバーで、次の操作を行ってください。

  • 各送信パケットに 802.1Q ヘッダーを挿入し、OOB からのデータを入力します (OOB に 0 以外のデータが存在すれば)。
  • NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES (NDIS_MAC_OPTION_8021P_PRIORITYNDIS_MAC_OPTION_8021Q_VLAN) で適切な MacOptions をアドバタイズします。

それ以外で、Tx フラグが無効になっている場合は、以下の通りです。

  • ミニポート フィルターは、OOB の 802.1Q 情報を受け入れてはいけません (なので、タグを挿入しません)。
  • ミニポート フィルターは、NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTESで適切な MacOptions をアドバタイズしないでください。

: ミニポート ドライバーが NDIS サービス品質 (QoS) をサポートしている場合は、*QOS キーワード 値も読み取る必要があります。 *QOS キーワード 値に基づいて、*PriorityVLANTag キーワード 値は異なる方法で解釈します。 詳細については、「NDIS QoS の標準化された INF キーワード」を参照してください。

*InterruptModeration
デバイスによる割り込みモデレーションが有効か無効かを示す値。 割り込みモデレーション アルゴリズムはデバイスに依存します。 デバイスの製造元は、標準化していないキーワードを使用してアルゴリズム設定をサポートできます。 割り込みモデレーションの詳細は、「割り込みモデレーション」をご覧ください。

*RSS
デバイスが有効か無効かを示す値は、受信側のスケーリング (RSS) を受け取ります。 virtual Receive-side Scaling (RSS) に関する詳細は、「サイドスケーリングを受け取る」をご覧ください。

*HeaderDataSplit
デバイスによるヘッダー データ分割が有効か無効かを示す値。 ヘッダー データ分割の詳細については、「ヘッダー データの分割」を参照してください。

接続オフロード サービスには、次のキーワード が関連付けられています。

*TCPConnectionOffloadIPv4

*TCPConnectionOffloadIPv6

接続オフロード キーワード の詳細は、「レジストリ値を使用した接続オフロードの有効化と無効化」を参照してください。

タスクに関連した接続オフロード サービスには、次のキーワード が関連付けられています。

*IPChecksumOffloadIPv4

*TCPChecksumOffloadIPv4

*TCPChecksumOffloadIPv6

*UDPChecksumOffloadIPv4

*UDPChecksumOffloadIPv6

*LsoV1IPv4

*LsoV2IPv4

注: IPv4 経由で大規模な送信オフロード バージョン 1 (LSOv1) と LSOv2 の両方をサポートするデバイスの場合は、INF ファイルとレジストリ値で *LsoV2IPv4 キーワード のみを使用しなければなりません。 たとえば、*LsoV2IPv4 キーワードが INF ファイルに表示され、*LsoV1IPv4 キーワードがレジストリに表示される場合 (またはその逆)、*LsoV2IPv4 キーワードを常時優先します。

*LsoV2IPv6

*IPsecOffloadV1IPv4

*IPsecOffloadV2

*IPsecOffloadV2IPv4

*TCPUDPChecksumOffloadIPv4

*TCPUDPChecksumOffloadIPv6

TCP/IP オフロード キーワードの詳細は、「レジストリ値を使用したタスク オフロードの有効化と無効化」を参照してください。

このトピックの最後の表の列では、列挙キーワードの次の属性について説明します。

SubkeyName
INF ファイルで指定する必要があり、レジストリに表示されるキーワードの名前。

ParamDesc
SubkeyName に関連付けられている表示テキスト。

Value
リスト内の各オプションに関連付けられている列挙整数値。 この値は、NDI\params\ SubkeyName\Value に格納されます。

EnumDesc
メニューに表示される各値に関連付けられている表示テキスト。

既定値
このメニューの既定値。

次の表は、すべてのキーワードの一覧と、ドライバーが上記の属性に使用する必要がある値を示しています。 キーワードの詳細については、WDK ドキュメントでそのキーワードを検索してください。

SubkeyName ParamDesc Value EnumDesc
*SpeedDuplex 速度& デュプレックス 0 (既定値) 自動ネゴシエーションを開始します
1 10 Mbps ハーフデュプレックス
2 10 Mbps フルデュプレックス
3 100 Mbps ハーフデュプレックス
4 100 Mbps フルデュプレックス
5 1.0 Gbps ハーフデュプレックス
6 1.0 Gbps フルデュプレックス
7 1.0 Gbps フルデュプレックス
8 20 Gbps フルデュプレックス
9 40 Gbps フルデュプレックス
10 100 Gbps フルデュプレックス
*FlowControl フロー制御 0 (サーバーの既定値) Tx&Rx 無効
1 送信有効
2 受信有効
3 (既定のクライアント) 受信&送信有効
4 自動ネゴシエーションを開始します
*PriorityVLANTag パケット優先度 & VLAN 0 パケット優先度 & VLAN 無効
1 パケット優先度を有効にする
2 VLAN が有効
3 (既定値) パケット優先度& VLAN 有効にする
*InterruptModeration 割り込み節度 0 無効
1 (既定値) Enabled
*RSS Receive Side Scaling 0 無効
1 (既定値) Enabled
*HeaderDataSplit ヘッダー データの分割 0 (既定値) 無効
1 Enabled
*TCPConnectionOffloadIPv4 TCP接続オフロード (IPv4) 0 無効
1 (既定値) Enabled
*TCPConnectionOffloadIPv6 TCP接続オフロード (IPv6) 0 無効
1 (既定値) Enabled
*IPChecksumOffloadIPv4 IPv4 チェックサム オフロード 0 無効
1 送信有効
2 受信有効
3 (既定値) 受信&送信有効
*TCPChecksumOffloadIPv4 TCP チェックサムオフロード (IPv4) 0 無効
1 送信有効
2 受信有効
3 (既定値) 受信&送信有効
*TCPChecksumOffloadIPv6 TCP チェックサムオフロード (IPv6) 0 無効
1 送信有効
2 受信有効
3 (既定値) 受信&送信有効
*UDPChecksumOffloadIPv4 UDP チェックサムオフロード (IPv4) 0 無効
1 送信有効
2 受信有効
3 (既定値) 受信&送信有効
*UDPChecksumOffloadIPv6 UDP チェックサムオフロード (IPv6) 0 無効
1 送信有効
2 受信有効
3 (既定値) 受信&送信有効
*LsoV1IPv4 大規模送信オフロード バージョン 1 (IPv4) 0 無効
1 (既定値) Enabled
*LsoV2IPv4 大規模送信オフロード バージョン 2 (IPv4) 0 無効
1 (既定値) Enabled
*LsoV2IPv6 大規模送信オフロード バージョン 2 (IPv6) 0 無効
1 (既定値) Enabled
*IPsecOffloadV1IPv4 IPsec オフロード バージョン 1 (IPv4) 0 無効
1 認証ヘッダーが有効
2 ESP が有効
3 (既定値) 認証ヘッダー& ESP有効
*IPsecOffloadV2 IPsecオフロード 0 無効
1 認証ヘッダーが有効
2 ESP が有効
3 (既定値) 認証ヘッダー& ESP有効
*IPsecOffloadV2IPv4 IPsecオフロード (IPv4のみ) 0 無効
1 認証ヘッダーが有効
2 ESP が有効
3 (既定値) 認証ヘッダー& ESP有効
*TCPUDPChecksumOffloadIPv4 TCP/UDPチェックサムオフロード (IPv4) 0 無効
1 送信有効
2 受信有効
3 (既定値) Tx および Rx を有効化する
*TCPUDPChecksumOffloadIPv6 TCP/UDPチェックサムオフロード (IPv6) 0 無効
1 送信有効
2 受信有効
3 (既定値) Tx および Rx を有効化する