通过

WdfRequestRetrieveOutputWdmMdl 函数 （wdfrequest.h）

  • 项目

[仅适用于 KMDF]

WdfRequestRetrieveOutputWdmMdl 方法检索表示 I/O 请求的输出缓冲区的内存描述符列表（MDL）。

语法

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

参数

[in] Request

框架请求对象的句柄。

[out] Mdl

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

返回值

WdfRequestRetrieveOutputWdmMdl 如果作成功，则返回STATUS_SUCCESS。 否则，此方法可能会返回以下值之一：

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

此方法也可能返回其他 NTSTATUS 值。

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

言论

请求的输出缓冲区接收来自磁盘的数据等信息，驱动程序提供给请求的发起方。 驱动程序可以针对读取请求或设备 I/O 控制请求调用 WdfRequestRetrieveOutputWdmMdl，但不能调用写入请求（因为写入请求不提供输出数据）。

WdfRequestRetrieveOutputWdmMdl 方法检索使用 缓冲 I/O 方法或用于访问数据缓冲区的 直接 I/O 方法的输出缓冲区的 MDL。 如果请求的 I/O 控制代码 IRP_MJ_INTERNAL_DEVICE_CONTROL，或者请求来自另一个内核模式驱动程序，WdfRequestRetrieveOutputWdmMdl 也支持使用 既没有缓冲的 I/O 请求，也不支持直接 I/O。

如果 WdfRequestRetrieveOutputWdmMdl 返回STATUS_SUCCESS，驱动程序将收到指向描述输出缓冲区的 MDL 的指针。

完成 I/O 请求后，驱动程序不得访问请求的 MDL。

有关 WdfRequestRetrieveOutputWdmMdl的详细信息，请参阅 访问 Framework-Based 驱动程序中的数据缓冲区。

例子

下面的代码示例是 EvtIoRead 回调函数的一部分，该函数获取 I/O 请求的输入缓冲区的 MDL。 如果调用 WdfRequestRetrieveOutputWdmMdl 失败，驱动程序将完成请求并返回错误状态 WdfRequestRetrieveOutputWdmMdl。

VOID 
MyDrvEvtIoRead(
    IN WDFQUEUE  Queue,
    IN WDFREQUEST  Request,
    IN size_t  Length
    )
{
    NTSTATUS  status;
    PMDL  mdl = NULL;
...
    status = WdfRequestRetrieveOutputWdmMdl(
                                            Request,
                                            &mdl
                                            );
    if (!NT_SUCCESS(status))
    {
        WdfRequestCompleteWithInformation(
                                          Request,
                                          status,
                                          0
                                          );
    }
...
}

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.0
标头 wdfrequest.h （包括 Wdf.h）
库 Wdf01000.sys（请参阅框架库版本控制。
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 DriverCreate（kmdf），InvalidReqAccess（kmdf），InvalidReqAccessLocal（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf），MdlAfterReqCompletedIntIoctl（kmdf），MdlAfterReqCompletedIntIoctlA（kmdf）， MdlAfterReqCompletedIoctl（kmdf）， MdlAfterReqCompletedIoctlA（kmdf）， MdlAfterReqCompletedRead（kmdf），MdlAfterReqCompletedReadA（kmdf）， MdlAfterReqCompletedWrite（kmdf）， OutputBufferAPI（kmdf）

另请参阅

WdfRequestRetrieveInputWdmMdl