フィードバック

ProbeForRead 関数 (wdm.h)

  • [アーティクル]

ProbeForRead ルーチンは、ユーザー モード バッファーがアドレス空間のユーザー部分に実際に存在し、正しくアラインされていることを確認します。

構文

void ProbeForRead(
  [in] const volatile VOID *Address,
  [in] SIZE_T              Length,
  [in] ULONG               Alignment
);

パラメーター

[in] Address

ユーザー モード バッファーの先頭を指定します。

[in] Length

ユーザー モード バッファーの長さをバイト単位で指定します。

[in] Alignment

ユーザー モード バッファーの先頭に必要なアラインメントをバイト単位で指定します。

戻り値

なし

解説

指定したメモリの範囲がユーザー モード のアドレス範囲内にない場合、 ProbeForRead はSTATUS_ACCESS_VIOLATION例外を発生させます。 アドレス範囲の先頭が Alignment で指定されたバイト境界にアラインされていない場合、 ProbeForRead はSTATUS_DATATYPE_MISALIGNMENT例外を発生させます。

カーネル モード ドライバーでは、 ProbeForRead を使用して、ユーザー空間に割り当てられているバッファーへの読み取りアクセスを検証する必要があります。 METHOD_NEITHER I/O 中に最も一般的に使用され、 Irp -> UserBuffer によって指されるユーザー バッファーを検証します。

ドライバーは、try/except ブロック内で ProbeForRead を呼び出す必要があります。 ルーチンで例外が発生した場合、ドライバーは適切なエラーで IRP を完了する必要があります。 ドライバーによるユーザー モード バッファーへの後続のアクセスは 、try/except ブロック内にもカプセル化する必要があることに注意してください。悪意のあるアプリケーションは、( ProbeForRead または ProbeForWrite の呼び出しの後、または呼び出し中であっても) いつでもユーザー アドレス範囲の保護を削除、置換、または変更する別のスレッドを持つ可能性があります。 詳細については、「例外の 処理」を参照してください。

カーネル モード アドレスでは、このルーチンを使用しないでください。例外が発生します。

Irp >RequestorModeKernelMode = の場合、Irp->AssociatedIrp.SystemBuffer フィールドと Irp->UserBuffer フィールドにはユーザー モード アドレスが含まれていません。また、ProbeForRead を呼び出して、いずれかのフィールドが指すバッファーをプローブすると、例外が発生します。

Length = 0 の場合、ProbeForRead はアドレスのチェックを行いません。 この場合、ルーチンは、位置がずれているか、有効なユーザー アドレスの範囲外のアドレスに対して例外を発生させません。

要件

   
サポートされている最小のクライアント Windows 2000 以降で使用できます。
対象プラットフォーム ユニバーサル
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL <= APC_LEVEL
DDI コンプライアンス規則 HwStorPortProhibitedDDIs(storport), IrqlExApcLte2(wdm)

関連項目

ProbeForWrite