OID_PNP_CAPABILITIES

[アーティクル]
04/03/2024

OID_PNP_CAPABILITIES OID は、ミニポートドライバーにネットワークアダプターのウェイクアップ機能を返すように要求するか、中間ドライバーに中間ドライバーのウェイクアップ機能を返すように要求します。ウェイクアップ機能は、次のように定義された NDIS_PNP_CAPABILITIES 構造として書式設定されます。

    typedef struct _NDIS_PNP_CAPABILITIES {
         ULONG Flags;
         NDIS_PM_WAKE_UP_CAPABILITIES WakeUpCapabilities;
    } NDIS_PNP_CAPABILITIES, *PNDIS_PNP_CAPABILITIES;

この構造体のメンバーには、次の情報が含まれています。

フラグ
NDIS_DEVICE_WAKE_UP_ENABLE

基になるミニポートドライバーが 1 つ以上のウェイクアップ機能をサポートしている場合、NDIS は、このフラグを設定します。プロトコルドライバーは、このフラグをテストして、基になるミニポートドライバーがウェイクアップ機能を持っているかどうかを特定します。ミニポートドライバーは、このフラグにアクセスできません。

WakeUpCapabilities
ミニポートドライバーのネットワークアダプターのウェイクアップ機能を指定する NDIS_PM_WAKE_UP_CAPABILITIES 構造体。 NDIS_PM_WAKE_UP_CAPABILITIES 構造体は次のように定義されています。

typedef struct _NDIS_PM_WAKE_UP_CAPABILITIES {
         NDIS_DEVICE_POWER_STATE MinMagicPacketWakeUp;
         NDIS_DEVICE_POWER_STATE MinPatternWakeUp;
         NDIS_DEVICE_POWER_STATE MinLinkChangeWakeUp;
       } NDIS_PM_WAKE_UP_CAPABILITIES, *PNDIS_PM_WAKE_UP_CAPABILITIES;

この構造体のメンバーには、次の情報が含まれています。

MinMagicPacketWakeUp
ミニポートドライバーのネットワークアダプターがマジックパケットの受信時にウェイクアップイベントを通知できるデバイスの最低電源状態を指定します。 (マジックパケットは、受信ネットワークアダプターのイーサネットアドレスの連続した 16 個のコピーを含むパケットです)。デバイスの電源状態は、次の NDIS_DEVICE_POWER_STATE 値のいずれかとして指定されます。

NdisDeviceStateUnspecified
ネットワークアダプターは、マジックパケットウェイクアップをサポートしていません。

NdisDeviceStateD0
ネットワークアダプターは、デバイスの電源状態 D0 からマジックパケットウェイクアップを通知できます。 D0 はフルパワー状態であるため、ウェイクアップは発生しませんが、実行時イベントとして使用できます。

NdisDeviceStateD1
ネットワークアダプターは、デバイスの電源状態 D1 および D0 からマジックパケットウェイクアップを通知できます。

NdisDeviceStateD2
ネットワークアダプターは、デバイスの電源状態 D2、D1、および D0 からマジックパケットウェイクアップを通知できます。

NdisDeviceStateD3
ネットワークアダプターは、デバイスの電源状態 D3、D2、D1、および D0 からマジックパケットウェイクアップを通知できます。

MinPatternWakeUp
プロトコルドライバーで指定されたパターンを含むネットワークフレームの受信時に、ミニポートドライバーのネットワークアダプターがウェイクアップイベントを通知できるデバイスの最低電源状態を指定します。電源状態は、次の NDIS_DEVICE_POWER_STATE 値のいずれかとして指定されます。

NdisDeviceStateUnspecified
ネットワークアダプターは、パターンマッチウェイクアップをサポートしていません。

NdisDeviceStateD0
ネットワークアダプターは、デバイスの電源状態 D0 からパターンマッチウェイクアップを通知できます。 D0 はフルパワー状態であるため、ウェイクアップは発生しませんが、実行時イベントとして使用できます。

NdisDeviceStateD1
ネットワークアダプターは、デバイスの電源状態 D1 および D0 からパターンマッチウェイクアップを通知できます。

NdisDeviceStateD2
ネットワークアダプターは、デバイスの電源状態 D2、D1、および D0 からパターンマッチウェイクアップを通知できます。

NdisDeviceStateD3
ネットワークアダプターは、デバイスの電源状態 D3、D2、D1、および D0 からパターンマッチウェイクアップを通知できます。

MinLinkChangeWakeUp
予約済み。 NDIS は、このメンバーを無視します。

ミニポートドライバーの場合

ミニポートドライバーの初期化が完了した後、プロトコルドライバーと NDIS は両方とも、この OID を使用してミニポートドライバーに対してクエリを実行し、以下を特定します。

ミニポートドライバーが PM 対応かどうか。
ネットワークウェイクアップイベントを示すネットワークアダプターの機能。

ミニポートドライバーが OID_PNP_CAPABILITIES のクエリに NDIS_STATUS_SUCCESS を返す場合、NDIS はミニポートドライバーを PM 対応と見なします。ミニポートドライバーが NDIS_STATUS_NOT_SUPPORTED を返す場合、NDIS は、ミニポートドライバーを PM 対応ではないレガシミニポートドライバーと見なします。

NdisMSetAttributesEx を呼び出すときに、ウェイクアップ機能をサポートしていないが、電源状態の遷移でネットワークアダプターの状態を保存および復元できるミニポートドライバーは、NDIS_ATTRIBUTE_NO_HALT_ON_SUSPEND フラグを設定できます。このフラグを設定すると、システムが低電力 (スリープ) 状態に移行する前に、NDIS はドライバーの MiniportHalt 関数を呼び出さなくなります。ただし、ミニポートドライバーがクエリ OID_PNP_CAPABILITIES に応答して NDIS_STATUS_NOT_SUPPORTED を返す場合は、NDIS は NDIS_ATTRIBUTE_NO_HALT_ON_SUSPEND フラグを無視して、システムが低電力状態になった場合、ネットワークアダプターを停止します。

ミニポートドライバーのネットワークアダプターは、ウェイクアップイベントがない場合も含め、ウェイクアップイベントの任意の組み合わせをサポートします。ミニポートドライバーは、ネットワークアダプターがウェイクアップイベントを通知できない場合でも、電源管理をサポートします。この場合、ミニポートドライバーが OID_PNP_CAPABILITIES に加えてサポートする唯一の電源管理 OID は、OID_PNP_QUERY_POWER と OID_PNP_SET_POWER です。

ミニポートドライバーのネットワークアダプターが特定のウェイクアップイベントをサポートしていない場合、ミニポートドライバーは、NDIS_PM_WAKE_UP_CAPABILITIES 構造体のウェイクアップイベントの NdisDeviceStateUnspecified の NDIS_DEVICE_POWER_STATE 値を示す必要があります。

OID_PNP_CAPABILITIES は、ミニポートドライバーのネットワークアダプターのウェイクアップ機能のみを示し、このような機能は有効にされません。 OID_PNP_ENABLE_WAKE_UP は、ネットワークアダプターのウェイクアップ機能を有効にするために使用されます。

中間ドライバーの場合

基になるネットワークアダプターが PM 対応の場合は、中間ドライバーは OID_PNP_CAPABILITIES のクエリに NDIS_STATUS_SUCCESS を返す必要があります。この OID によって返される NDIS_PM_WAKE_UP_CAPABILITIES 構造体では、中間ドライバーは、ウェイクアップ機能 (MinMagicPacketWakeUp or MinPatternWakeUp) ごとに NdisDeviceStateUnspecified のデバイスの電源状態を指定する必要があります。このような応答は、中間ドライバーが PM 対応であるが、物理デバイスを管理していないことを示します。

基になるネットワークアダプターが PM 対応でない場合は、中間ドライバーは NDIS_STATUS_NOT_SUPPORTED を OID_PNP_CAPABILITIES のクエリに返す必要があります。

注 NDIS 6.20 以降のミニポートドライバーが電源管理機能を報告する方法については、「電源管理機能の報告」を参照してください。

要件

バージョン	NDIS 6.0 と NDIS 6.1 でサポートされています NDIS 6.20 以降の場合は、代わりに OID_PM_CURRENT_CAPABILITIES を使用します。
ヘッダー	Ntddndis.h (Ndis.h を含む)

OID_PNP_CAPABILITIES

要件

関連項目

フィードバック

フィードバック

その他のリソース