OID_PM_WOL_PATTERN_LIST
上部のドライバーは、クエリとして、OID_PM_WOL_PATTERN_LIST OID を使用して、基になるネットワーク アダプターに設定されている Wake On LAN パターンを列挙できます。 クエリから正常に返されると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、現在追加されている WOL パターンを記述する NDIS_PM_WOL_PATTERN 構造体の一覧へのポインターが含まれています。
解説
NDIS は、ミニポート ドライバーのクエリを処理します。 NDIS ドライバーは、OID_PM_WOL_PATTERN_LIST OID を使用して、基になるネットワーク アダプターに設定されている LAN パターンのスリープ解除の一覧を取得できます。
一覧の各 NDIS_PM_WOL_PATTERN 構造体に対して、NDIS は、OID 情報バッファーの先頭 (つまり、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーが指す バッファーの先頭) からリスト内の次の NDIS_PM_WOL_PATTERN 構造体の先頭まで、NextWoLPatternOffset メンバーをオフセットに設定します。 一覧の最後の構造体の NextWoLPatternOffset メンバーのオフセットは 0 です。
NextWoLPatternOffset 以外の NDIS_PM_WOL_PATTERN 構造体のオフセット (NameBufferOffset など) の場合、NDIS は各 NDIS_PM_WOL_PATTERN 構造体の先頭を基準にしたオフセットを提供します。
ネットワーク アダプターで設定されている WOL パターンがない場合、NDIS は、NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesWritten メンバーを 0 に設定し、要求の NDIS_STATUS_SUCCESS を返します。 DATA.QUERY_INFORMATION.InformationBuffer メンバー内のデータは、NDIS によって変更されません。
NDIS は、この要求に対して次のいずれかの状態コードを返します。
NDIS_STATUS_SUCCESS
要求は正常に完了しました。 InformationBuffer には、WOL パターンの一覧へのポインターが含まれています (ある場合)。
NDIS_STATUS_PENDING
要求の完了が保留中です。 最終的な状態コードと結果は、呼び出し元の OID 要求完了ハンドラーに渡されます。
NDIS_STATUS_BUFFER_TOO_SHORT
情報バッファーが短すぎました。 NDIS は、NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズを設定します。
NDIS_STATUS_FAILURE
上記の理由以外の理由で要求が失敗しました。
要件
バージョン |
NDIS 6.20 以降でサポートされています。 ミニポート ドライバーには要求されません (「解説」を参照してください)。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |