WdfRequestProbeAndLockUserBufferForWrite 函数 （wdfrequest.h）
[仅适用于 KMDF]
WdfRequestProbeAndLockUserBufferForWrite 方法验证 I/O 请求的用户模式缓冲区是否可写，然后锁定缓冲区的物理内存页，以便驱动程序堆栈中的驱动程序可以写入缓冲区。
语法
NTSTATUS WdfRequestProbeAndLockUserBufferForWrite(
[in] WDFREQUEST Request,
[in] PVOID Buffer,
[in] size_t Length,
[out] WDFMEMORY *MemoryObject
);
参数
[in] Request
框架请求对象的句柄。
[in] Buffer
指向请求的输出缓冲区的指针。 有关详细信息，请参阅以下“备注”部分。
[in] Length
请求的输出缓冲区的长度（以字节为单位）。
[out] MemoryObject
指向一个位置的指针，该位置接收表示用户输出缓冲区的框架内存对象的句柄。
返回值
WdfRequestProbeAndLockUserBufferForWrite 如果作成功，则返回STATUS_SUCCESS。 否则，此方法可能会返回以下值之一：
| 返回代码 | 描述 |
|---|---|
|
输入参数无效。 |
|
Length 参数为零。 |
|
请求已完成或无效。 |
|
当前线程不是 I/O 请求的创建者。 |
|
内存不足，无法完成作。 |
此方法也可能返回其他 NTSTATUS 值。
如果驱动程序提供无效的对象句柄，则会发生 bug 检查。
言论
用户输出缓冲区通常接收驱动程序从设备读取的信息。
只有顶级驱动程序才能调用 WdfRequestProbeAndLockUserBufferForWrite 方法，因为该方法需要创建 I/O 请求的进程的进程上下文。
Buffer 参数指定的用户模式缓冲区可以是 WdfRequestRetrieveUnsafeUserOutputBuffer 检索的缓冲区，也可以是不同的用户模式输出缓冲区。 例如，使用缓冲访问方法的 I/O 控制代码可能会传递包含指向用户模式缓冲区的嵌入指针的结构。 在这种情况下，驱动程序可以使用WdfRequestProbeAndLockUserBufferForWrite 获取缓冲区的内存对象。
Length 参数指定的缓冲区长度不得大于缓冲区的实际大小。 否则，驱动程序可以访问缓冲区外部的内存，这是一个安全风险。
如果 WdfRequestProbeAndLockUserBufferForWrite 返回STATUS_SUCCESS，驱动程序将收到表示用户模式缓冲区的框架内存对象的句柄。 若要访问缓冲区，驱动程序必须调用 WdfMemoryGetBuffer。
驱动程序调用 WdfRequestComplete时，会自动释放框架内存对象。
有关 WdfRequestProbeAndLockUserBufferForWrite的详细信息，请参阅 访问 Framework-Based 驱动程序中的数据缓冲区。
例子
有关使用 WdfRequestProbeAndLockUserBufferForWrite的代码示例，请参阅 WdfRequestProbeAndLockUserBufferForRead。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 标头 | wdfrequest.h （包括 Wdf.h） |
| 库 | Wdf01000.sys（请参阅框架库版本控制。 |
| IRQL | PASSIVE_LEVEL |
| DDI 符合性规则 | DriverCreate（kmdf），InvalidReqAccess（kmdf），InvalidReqAccessLocal（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf） |