OID_PNP_ADD_WAKE_UP_PATTERN

OID_PNP_ADD_WAKE_UP_PATTERN OID は、プロトコル ドライバーによってミニポート ドライバーに送信され、ウェイクアップ パターンを指定します。 ウェイクアップ パターンとそのマスクは、NDIS_PM_PACKET_PATTERN 構造体によって記述されます。

ミニポート ドライバーのパターン マッチ ウェイクアップを有効にするプロトコル (「OID_PNP_ENABLE_WAKE_UP」を参照) は、OID_PNP_ADD_WAKE_UP_PATTERN を使用して、ウェイクアップ パターンを指定します。 ウェイクアップ パターンは、ネットワーク アダプターの機能に応じて、ホスト メモリまたはネットワーク アダプターに格納できます。

NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、次のものが含まれます。

• パターンとそのマスクに関する情報を提供する NDIS_PM_PACKET_PATTERN 構造体。

• パターン内の対応するバイトと比較する必要がある受信パケットのバイトを示すマスク。 マスクは、パケットの最初のバイトから始まります。 マスクは、InformationBuffer 内の NDIS_PM_PACKET_PATTERN 構造体の直後に続きます。 このマスクの機能の詳細については、「 ネットワーク デバイス クラスの電源管理リファレンスの仕様」を参照してください。

• InformationBuffer の先頭から PatternOffset バイトを開始するウェイクアップ パターン。 ウェイクアップ パターンの詳細については、「 ネットワーク デバイス クラスの電源管理リファレンスの仕様」を参照してください。

ミニポート ドライバーがプロトコルから受け入れることができるウェイクアップ パターンの数は、ミニポート ドライバーがこのようなパターンに割り当てたホスト メモリや、ネットワーク アダプター内の使用可能な記憶域など、リソースの可用性によって異なる場合があります。 リソースが不十分なためにミニポート ドライバーがウェイクアップ パターンを追加できない場合、ミニポート ドライバーは、OID_PNP_ADD_WAKE_UP_PATTERN に応答して、NDIS_STATUS_RESOURCES を返します。

プロトコル ドライバーが重複するパターンを追加しようとすると、ミニポート ドライバーは、OID_PNP_ADD_WAKE_UP_PATTERN に応答して、NDIS_STATUS_INVALID_DATA を返す必要があります。

上位がこの OID 要求を受信する中間ドライバーは、NdisRequest または NdisCoRequest を呼び出すことによって、基になるミニポート ドライバーに要求を常に伝達する必要があります。

要件

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

関連項目

NDIS_PM_PACKET_PATTERN

OID_PM_ADD_WOL_PATTERN