WdfRequestRetrieveInputWdmMdl 函数 (wdfrequest.h)

[仅适用于 KMDF]

WdfRequestRetrieveInputWdmMdl 方法 (表示 I/O 请求的输入缓冲区的 MDL) 检索内存描述符列表。

语法

NTSTATUS WdfRequestRetrieveInputWdmMdl(
  [in]  WDFREQUEST Request,
  [out] PMDL       *Mdl
);

参数

[in] Request

框架请求对象的句柄。

[out] Mdl

指向接收指向 MDL 的指针的位置的指针。

返回值

如果操作成功,WdfRequestRetrieveInputWdmMdl 将返回STATUS_SUCCESS。 否则,此方法可能会返回以下值之一:

返回代码 说明
STATUS_INVALID_PARAMETER
输入参数无效。
STATUS_INVALID_DEVICE_REQUEST
请求类型无效,或者请求 既不使用缓冲 I/O,也不使用直接 I/O。 有关用于访问数据缓冲区的受支持方法的详细信息,请参阅以下“备注”部分。
STATUS_INTERNAL_ERROR
请求已完成。
STATUS_BUFFER_TOO_SMALL
输入缓冲区的长度为零。
STATUS_INSUFFICIENT_RESOURCES
内存不足。
 

此方法还可能返回其他 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)

另请参阅

WdfRequestRetrieveOutputWdmMdl