NDIS_PM_PARAMETERS 構造体 (ntddndis.h)

[アーティクル]
06/20/2023

NDIS_PM_PARAMETERS構造体は、ネットワークアダプターに対して有効になっている現在または新しい電源管理ハードウェア機能を指定します。

構文

typedef struct _NDIS_PM_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              EnabledWoLPacketPatterns;
  ULONG              EnabledProtocolOffloads;
  ULONG              WakeUpFlags;
  ULONG              MediaSpecificWakeUpEvents;
} NDIS_PM_PARAMETERS, *PNDIS_PM_PARAMETERS;

メンバー

Header

NDIS_PM_PARAMETERS構造体の型、リビジョン、サイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

ミニポートドライバーは、ヘッダーの Type メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_PM_PARAMETERS構造体のバージョンを指定するには、ドライバーは Header の Revision メンバーを次の値に設定する必要があります。

NDIS_PM_PARAMETERS_REVISION_2

NDIS 6.30 のさまざまな変更を追加しました。

[サイズ] メンバーを [NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_2] に設定します。

NDIS_PM_PARAMETERS_REVISION_1

NDIS 6.20 の元のバージョン。

[サイズ] メンバーを [NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_1] に設定します。

EnabledWoLPacketPatterns

ミニポートドライバーがNDIS_PM_CAPABILITIES構造体のSupportedWoLPacketPatterns メンバーで報告された機能に対応するフラグのビットごとの OR を含む ULONG 値。 NDIS では、これらのフラグを使用して、ネットワークアダプターが低電力状態からローカルコンピューターをスリープ解除するために使用する wake-on-LAN (WOL) パターンを有効にします。 WOL パターンの詳細については、「 NDIS_PM_WOL_PATTERN」を参照してください。

次のフラグが使用されます。

NDIS_PM_WOL_BITMAP_PATTERN_ENABLED

このフラグが設定されている場合、ネットワークアダプターは、構成されたビットマップパターンに一致するパケットを受信したときにウェイクアップイベントを生成するように有効になります。

NDIS_PM_WOL_MAGIC_PACKET_ENABLED

このフラグが設定されている場合、ネットワークアダプターは、WOL マジックパケットを受信したときにウェイクアップイベントを生成するために有効になります。 マジックパケットは、ペイロード内に、値が 0xFF の 6 バイトの文字列を含み、その直後に受信ネットワークアダプターのメディアアクセス制御 (MAC) アドレスの連続した 16 個のコピーが格納されます。

NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_ENABLED

このフラグが設定されている場合、ネットワークアダプターは、EAPOL 要求識別子メッセージを受信したときにウェイクアップイベントを生成するために有効になります。

NDIS_PM_WOL_IPV4_TCP_SYN_ENABLED

このフラグが設定されている場合、ネットワークアダプターは、IPv4 TCP SYN パケットを受信したときにウェイクアップイベントを生成するために有効になります。リモートホストは、TCP SYN パケットを送信して、ローカルコンピューターへの TCP 接続を開始します。

NDIS_PM_WOL_IPV6_TCP_SYN_ENABLED

このフラグが設定されている場合、ネットワークアダプターは、IPv6 TCP SYN パケットを受信したときにウェイクアップイベントを生成するために有効になります。

NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED

このフラグが設定されている場合、ネットワークアダプターは、WOL パターンの IPv4 アドレスと TCP/UDP ポートに対して、ゼロで塗りつぶされた値 (指定されていない値) をワイルドカード値として扱う必要があります。このようにして、ワイルドカード値は、WOL パターンで指定された場所にある受信パケットの IPv4 アドレスと任意のポート値と一致します。

このフラグが設定されている場合、次のパターンマッチング条件が true の場合、ネットワークアダプターはウェイクアップイベントを生成するように有効になります。

WOL パターンで指定された場所の受信パケットからの値は、その場所の WOL パターンにワイルドカード値が含まれている場合に一致します。
WOL パターンで指定された場所の受信パケットからの値は、その場所の WOL パターンにパケットの値と等しい 0 以外の値が含まれている場合に一致します。

注意

このフラグで有効になっているワイルドカード値には、指定されていない IPv4 送信元アドレスと宛先アドレス、および指定されていない送信元ポートと宛先ポートを含めることができます。

NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED

このフラグが設定されている場合、ネットワークアダプターは、WOL パターンの IPv6 アドレスと TCP/UDP ポートに対して、ゼロで塗りつぶされた値 (指定されていない値) をワイルドカード値として扱う必要があります。このようにして、ワイルドカード値は、WOL パターンで指定された場所にある受信パケットの IPv6 アドレスと任意のポート値と一致します。

WOL パターンで指定された場所の受信パケットからの値は、その場所の WOL パターンにワイルドカード値が含まれている場合に一致します。
WOL パターンで指定された場所の受信パケットからの値は、その場所の WOL パターンにパケットの値と等しい 0 以外の値が含まれている場合に一致します。

注意

このフラグで有効になっているワイルドカード値には、指定されていない IPv6 送信元アドレスと宛先アドレス、および指定されていない送信元ポートと宛先ポートを含めることができます。

EnabledProtocolOffloads

ミニポートドライバーがNDIS_PM_CAPABILITIES構造体のSupportedProtocolOffloads メンバーで報告された機能に対応するフラグのビットごとの OR を含む ULONG 値。 NDIS では、これらのフラグを使用して、ネットワークアダプターで低電力プロトコルオフロード機能を有効にします。次のフラグが使用されます。

NDIS_PM_PROTOCOL_OFFLOAD_ARP_ENABLED

このビットが設定されている場合、基になるドライバーは、ARP プロトコルオフロード機能を有効にするネットワークアダプターを要求します。このプロトコルオフロードは、 OID_PM_ADD_PROTOCOL_OFFLOADのセット要求によって構成されるとすぐに、ドライバーは、低電力状態にある間に IPv4 ARP パケットに応答するネットワークアダプターを有効にする必要があります。

NDIS_PM_PROTOCOL_OFFLOAD_NS_ENABLED

このビットが設定されている場合、基になるドライバーは、IPv6 近隣要請 (NS) プロトコルオフロード機能を有効にするネットワークアダプターを要求します。このプロトコルオフロードが OID_PM_ADD_PROTOCOL_OFFLOAD のセット要求によって構成されるとすぐに、ドライバーはネットワークアダプターが低電力状態にある間に NS パケットに応答できるようにする必要があります。

NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_ENABLED

このビットが設定されている場合、基になるドライバーは、IEEE 802.11i 堅牢セキュリティネットワーク (RSN) プロトコルオフロード機能を有効にするネットワークアダプターを要求します。このプロトコルオフロードが OID_PM_ADD_PROTOCOL_OFFLOAD のセット要求によって構成されるとすぐに、ドライバーはネットワークアダプターが低電力状態にある間に RSN の再キー要求パケットに応答できるようにする必要があります。

WakeUpFlags

Xxx フラグのビットごとの OR NDIS_PM_WAKE_ON_含む ULONG 値。 NDIS では、これらのフラグを使用して、ネットワークアダプターでウェイクアップ機能を有効にします。このメンバーは、次のフラグを使用します。

NDIS_PM_WAKE_ON_LINK_CHANGE_ENABLED

このフラグが設定されている場合、ネットワークアダプターは、リンクの状態がメディアから接続されているメディアに変更されたときにウェイクアップイベントを生成するために有効になります。

この WOL 機能の詳細については、「メディア切断時の低電力」を参照してください。

NDIS_PM_WAKE_ON_MEDIA_DISCONNECT_ENABLED

このフラグが設定されている場合、ネットワークアダプターは、切断されたメディアに接続されているメディアからリンクの状態が変化したときにウェイクアップイベントを生成するために有効になります。

NDIS_PM_SELECTIVE_SUSPEND_ENABLED

このフラグが設定されている場合、ネットワークアダプターは、次のいずれかのイベントが発生するたびにウェイクアップイベントを生成するように有効になります。

ネットワークアダプターは、受信パケットフィルターに一致するパケットを受信します。アダプターは、 OID_GEN_CURRENT_PACKET_FILTERの OID セット要求を通じてこれらのフィルターを使用して構成されます。
ネットワークアダプターは、リンク状態がメディアの切断またはメディア接続のいずれかに変わる場合など、ネットワークドライバースタックによる処理を必要とする他の外部イベントを検出します。

注意

NDIS_PM_SELECTIVE_SUSPEND_ENABLED フラグは、NDIS 6.30 以降で使用できます。

このフラグが設定されている場合、 WakeUpFlags メンバーに他の電源管理フラグを設定することはできません。 EnabledWoLPacketPatterns メンバーを 0 に設定する必要があります。

NDIS は 、NDIS_PM_SELECTIVE_SUSPEND_ENABLED フラグを設定する場合は、ミニポートドライバーに直接 OID_PM_PARAMETERS の OID セット要求を発行します。これにより、NDIS は、ネットワークドライバースタック内のフィルタードライバーによる処理をバイパスできます。

選択的な中断電源管理機能の詳細については、「 NDIS 選択的中断」を参照してください。

MediaSpecificWakeUpEvents

フラグのビットごとの OR を含む ULONG 値。これらのフラグは、ネットワークアダプターがサポートするメディア固有のウェイクアップイベントを指定します。

NDIS 6.30 以降では、次のフラグが定義されています。

NDIS_WLAN_WAKE_ON_NLO_DISCOVERY_ENABLED

このフラグが設定されている場合、802.11 ネットワークアダプターは、ネットワークオフロード (NLO) で指定されたサービスセット識別子 (SSID) を検出したときにウェイクアップイベントを生成するために有効になります。

NLO の詳細については、「Wi-Fi ネットワークリストオフロード」を参照してください。

NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_ENABLED

このフラグが設定されている場合、802.11 ネットワークアダプターは、アクセスポイント (AP) との関連付けを解除するときにウェイクアップイベントを生成するために有効になります。

NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_ENABLED

このフラグが設定されている場合、802.11 ネットワークアダプターは、AP との IEEE 802.11i RSN グループ一時キー (GTK) ハンドシェイク中にエラーが発生したときにウェイクアップイベントを生成するために有効になります。

NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_ENABLED

このフラグが設定されている場合、802.11 ネットワークアダプターは、AP との IEEE 802.11i RSN 4 ウェイハンドシェイクの最初のフレームを受信したときにウェイクアップイベントを生成するために有効になります。このハンドシェイクは、アダプターが AP で認証されるときに実行されます。

NDIS_WWAN_WAKE_ON_REGISTER_STATE_ENABLED

このフラグを設定すると、モバイルブロードバンド (MB) ネットワークアダプターが有効になって、MB サービスへの登録状態が変更されたときにウェイクアップイベントが生成されます。

NDIS_WWAN_WAKE_ON_SMS_RECEIVE_ENABLED

このフラグが設定されている場合、MB ネットワークアダプターは、ショートメッセージサービス (SMS) メッセージの受信について MB サービスに通知する必要があるときに、ウェイクアップイベントを生成するために有効になります。アダプターは、以前に発行された OID_WWAN_SMS_READ クエリ要求の完了後、またはイベント通知としてネットワークプロバイダーから新しいクラス 0 (フラッシュ/アラート) メッセージが到着した後に、このウェイクアップイベントを生成します。

NDIS_WWAN_WAKE_ON_USSD_RECEIVE_ENABLED

このフラグが設定されている場合、MB ネットワークアダプターは、非構造化補助サービスデータ (USSD) メッセージを受信したときにウェイクアップイベントを生成できます。

NDIS_WWAN_WAKE_ON_PACKET_STATE_ENABLED

このフラグが設定されている場合、MB ネットワークアダプターは、携帯パケットデータの可用性が変更されたときにウェイクアップイベントを生成するために有効になります。このフラグは、Windows 10の新しいフラグです。

NDIS_WWAN_WAKE_ON_UICC_CHANGE_ENABLED

このフラグを設定すると、UICC (SIM) カードが挿入、削除、またはエラー状態になったときに、MB ネットワークアダプターでウェイクアップイベントが生成されます。このフラグは、Windows 10の新しいフラグです。

注釈

NDIS_PM_PARAMETERS構造体は、OID_PM_PARAMETERS OID に対して有効な電源管理ハードウェア機能を指定します。 OID_PM_PARAMETERS OID のクエリが実行されると、この構造によって現在の電源管理構成が提供されます。 OID_PM_PARAMETERS OID が設定されている場合、この構造体は、ネットワークアダプターで使用する必要がある新しい電源管理構成を指定します。

基になるドライバーは、ネットワークアダプターがサポートしていない機能を有効にしないでください。ネットワークアダプターが提供する機能を決定する上にあるドライバーを有効にするには、NDIS は、NDIS_BIND_PARAMETERS構造体の PowerManagementCapabilitiesEx メンバーの機能を提供します。

注意

NDIS 6.20 以降のドライバーでは、 PowerManagementCapabilities メンバーではなく、NDIS_BIND_PARAMETERS 構造体の PowerManagementCapabilitiesEx メンバーを使用する必要があります。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.20 以降でサポートされています。
Header	ntddndis.h (Ntddndis.h を含む)

こちらもご覧ください

OID_GEN_CURRENT_PACKET_FILTER

OID_PM_PARAMETERS