WdfRequestRetrieveInputWdmMdl 函数 (wdfrequest.h)
[仅适用于 KMDF]
WdfRequestRetrieveInputWdmMdl 方法 (表示 I/O 请求的输入缓冲区的 MDL) 检索内存描述符列表。
语法
NTSTATUS WdfRequestRetrieveInputWdmMdl(
[in] WDFREQUEST Request,
[out] PMDL *Mdl
);
参数
[in] Request
框架请求对象的句柄。
[out] Mdl
指向接收指向 MDL 的指针的位置的指针。
返回值
如果操作成功,WdfRequestRetrieveInputWdmMdl 将返回STATUS_SUCCESS。 否则,此方法可能会返回以下值之一:
返回代码 | 说明 |
---|---|
|
输入参数无效。 |
|
请求类型无效,或者请求 既不使用缓冲 I/O,也不使用直接 I/O。 有关用于访问数据缓冲区的受支持方法的详细信息,请参阅以下“备注”部分。 |
|
请求已完成。 |
|
输入缓冲区的长度为零。 |
|
内存不足。 |
此方法还可能返回其他 NTSTATUS 值。
如果驱动程序提供无效的对象句柄,则会发生 bug 检查。
注解
请求的输入缓冲区包含由请求发起方提供的信息,例如要写入磁盘的数据。 驱动程序可以为写入请求或设备 I/O 控制请求调用 WdfRequestRetrieveInputWdmMdl ,但不能调用读取请求 (,因为读取请求不提供) 输入数据。
WdfRequestRetrieveInputWdmMdl 方法检索使用缓冲 I/O 方法或直接 I/O 方法访问数据缓冲区的 I/O 请求的输入缓冲区的 MDL。 如果请求的 I/O 控制代码 IRP_MJ_INTERNAL_DEVICE_CONTROL,或者请求来自另一个内核模式驱动程序, 则 WdfRequestRetrieveInputWdmMdl 还支持 既不使用缓冲 I/O,也不使用直接 I/O 的 I/O 请求。
如果 WdfRequestRetrieveInputWdmMdl 返回STATUS_SUCCESS,则驱动程序将收到指向描述输入缓冲区的 MDL 的指针。
完成 I/O 请求后,驱动程序不得访问请求的 MDL。
有关 WdfRequestRetrieveInputWdmMdl 的详细信息,请参阅 访问 Framework-Based 驱动程序中的数据缓冲区。
示例
下面的代码示例是 EvtIoWrite 回调函数的一部分,该函数获取 I/O 请求输入缓冲区的 MDL。 如果对 WdfRequestRetrieveInputWdmMdl 的调用失败,驱动程序会以 WdfRequestRetrieveInputWdmMdl 返回的错误状态完成请求。
VOID
MyDrvEvtIoWrite(
IN WDFQUEUE Queue,
IN WDFREQUEST Request,
IN size_t Length
)
{
NTSTATUS status;
PMDL mdl = NULL;
...
status = WdfRequestRetrieveInputWdmMdl(
Request,
&mdl
);
if (!NT_SUCCESS(status))
{
WdfRequestCompleteWithInformation(
Request,
status,
0
);
}
...
}
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
最低 KMDF 版本 | 1.0 |
标头 | wdfrequest.h (包括 Wdf.h) |
Library | Wdf01000.sys (请参阅框架库 Versioning.) |
IRQL | <=DISPATCH_LEVEL |
DDI 符合性规则 | DriverCreate (kmdf) ,InputBufferAPI (kmdf ) ,InvalidReqAccess (kmdf ) ,InvalidReqAccessLocal () kmdf) 、KmdfIrql (kmdf) 、KmdfIrql2 (kmdf) 、KmdfIrqlExplicit (kmdf) 、 MdlAfterReqCompletedIntIoctl (kmdf) , MdlAfterReqCompletedIntIoctlA (kmdf) , MdlAfterReqCompletedIoctl (kmdf) , MdlAfterReqCompletedIoctlA (kmdf) , MdlAfterReqCompletedRead (kmdf) , MdlAfterReqCompletedWrite (kmdf) , MdlAfterReqCompletedWriteA (kmdf) |