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 來驗證用戶空間中配置之緩衝區的讀取許可權。 在 I/O METHOD_NEITHER期間最常用來驗證 Irp -> UserBuffer 所指向的使用者緩衝區。

驅動程式必須在 try/except 區塊內呼叫 ProbeForRead。 如果例程引發例外狀況，驅動程式應該會以適當的錯誤完成 IRP。 請注意，驅動程式對使用者模式緩衝區的後續存取也必須封裝在 try/except 區塊內：惡意應用程式可能會有另一個線程刪除、替代或變更使用者位址範圍的保護，即使在 呼叫 ProbeForRead 或ProbeForWrite) 期間也一樣 (。 如需詳細資訊，請參閱 處理例外狀況。

請勿在內核模式位址上使用此例程;它會引發例外狀況。

如果 Irp-RequestorMode> KernelMode = ，則 Irp-AssociatedIrp.SystemBuffer> 和 Irp-UserBuffer> 字段不包含使用者模式位址，而 ProbeForRead 呼叫探查任一字段所指向的緩衝區將會引發例外狀況。

如果 Length = 0，ProbeForRead 就不會檢查位址。 在此情況下，例程不會針對未對齊或超出有效用戶位址範圍的位址引發例外狀況。

規格需求

需求 值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= APC_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) 、 IrqlExApcLte2 (wdm)

另請參閱

ProbeForWrite