OID_PM_ADD_WOL_PATTERN
セットとして、NDIS プロトコル ドライバーは、ネットワーク アダプターに電源管理ウェイク オン LAN パターンを追加するOID_PM_ADD_WOL_PATTERN OID を使用します。 NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_PM_WOL_PATTERN 構造体へのポインターが含まれています。
備考
NDIS 6.20 以降のプロトコル ドライバーは、ネットワーク アダプターに Wake on LAN (WOL) パターンを追加するOID_PM_ADD_WOL_PATTERNを使用します。 OID 要求には、ネットワーク アダプターが低電力状態のときに受信パケットと比較する必要がある条件が含まれています。 ネットワーク アダプターは、パターン条件に一致するパケットを受信したときにウェイク アップ イベントを生成する必要があります。
プロトコル ドライバーは、基になるネットワーク アダプターに正常にバインドした後、および必要なデータ (インターフェイスの IP アドレスなど) を取得して、WOL パターンを設定するとすぐに、WOL パターンを追加できます。 プロトコル ドライバーは、以前に追加された WOL パターンやオフロードされたプロトコルの拒否など、他の電源管理イベント通知に応答して、WOL パターンを追加することもできます。
NDIS と同じミニポート アダプターにバインドされている他のプロトコル ドライバーの競合状態を回避するには、NDIS が低電力状態にネットワーク アダプターの設定を開始した後、そのネットワーク アダプターに新しいウェイク アップ パターンを追加しようとして失敗します。 たとえば、NDIS プロトコル ドライバーが、そのネットワーク アダプターの NetEventSetPower イベント通知を処理するコンテキストで新しい WOL パターンを追加しようとすると、NDIS は要求に失敗します。
NDIS は、基になる NDIS ドライバーにこの OID 要求を送信するか、または上にあるドライバーに要求を完了する前に、NDIS_PM_WOL_PATTERN 構造体のメンバー 一意の値に ULONG PatternId を設定します。 プロトコル ドライバーと NDIS は、基になるネットワーク アダプターから WOL パターンを削除する OID_PM_REMOVE_WOL_PATTERN OID 要求でこのパターン識別子を使用します。
注意 パターン識別子は、ネットワーク アダプターに設定されている各パターンの一意の値です。 ただし、パターン識別子は、すべてのミニポート アダプター全体でグローバルに一意ではありません。
NDIS または基になるネットワーク アダプターが、WOL パターンを削除すると、NDIS_STATUS_PM_WOL_PATTERN_REJECTED 状態を示す値が生成されます。 NDIS_STATUS_INDICATION 構造体の StatusBuffer メンバーには、拒否された WOL パターンの ULONG WOL パターン識別子が含まれています。
ミニポート ドライバーは、要求の次の状態コードのいずれかを返します。
NDIS_STATUS_SUCCESS
要求されたパターンが正常に追加されました。
PatternId NDIS_PM_WOL_PATTERN構造体のメンバーには、パターン識別子が含まれています。
NDIS_STATUS_PENDING
要求の完了が保留中です。 NDIS は、要求が完了した後、呼び出し元の OID 要求完了ハンドラーに最終的な状態コードと結果を渡します。
NDIS_STATUS_PM_WOL_PATTERN_LIST_FULL
パターン リストがいっぱいで、ネットワーク アダプターが別のパターンを追加できないため、要求は失敗しました。
NDIS_STATUS_RESOURCES
NDIS または基になるネットワーク アダプターは、リソースがないために新しいパターンを追加できませんでした。
NDIS_STATUS_INVALID_PARAMETER
NDIS_PM_WOL_PATTERN構造体の 1 つ以上のパラメーターが無効でした。
NDIS_STATUS_BUFFER_TOO_SHORT
情報バッファーが短すぎます。 NDIS は、データを設定します。SET_INFORMATION。BytesNeeded 必要な最小バッファー サイズにNDIS_OID_REQUEST構造体のメンバーです。
NDIS_STATUS_NOT_SUPPORTED
ネットワーク アダプターは、要求された WOL パターンをサポートしていません。
NDIS_STATUS_FAILURE
上記の理由以外の理由で要求が失敗しました。
必要条件
バージョン |
NDIS 6.20 以降でサポートされています。 ミニポート ドライバーには必須です。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |