wdfrequest.h 标头

wdf 使用此标头。 有关详细信息，请参阅：

• Windows 驱动程序框架

wdfrequest.h 包含以下编程接口：

函数

WDF_REQUEST_COMPLETION_PARAMS_INIT WDF_REQUEST_COMPLETION_PARAMS_INIT 函数初始化WDF_REQUEST_COMPLETION_PARAMS结构。
WDF_REQUEST_FORWARD_OPTIONS_INIT WDF_REQUEST_FORWARD_OPTIONS_INIT 函数初始化WDF_REQUEST_FORWARD_OPTIONS结构。
WDF_REQUEST_PARAMETERS_INIT WDF_REQUEST_PARAMETERS_INIT 函数初始化WDF_REQUEST_PARAMETERS结构。
WDF_REQUEST_REUSE_PARAMS_INIT WDF_REQUEST_REUSE_PARAMS_INIT 函数初始化驱动程序WDF_REQUEST_REUSE_PARAMS结构。
WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP 函数在驱动程序的WDF_REQUEST_REUSE_PARAMS结构中设置新的 IRP。
WDF_REQUEST_SEND_OPTIONS_INIT WDF_REQUEST_SEND_OPTIONS_INIT 函数初始化驱动程序的WDF_REQUEST_SEND_OPTIONS结构。
WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT 函数在驱动程序的WDF_REQUEST_SEND_OPTIONS结构中设置超时值。
WdfRequestAllocateTimer WdfRequestAllocateTimer 方法为指定的 I/O 请求分配计时器。
WdfRequestCancelSentRequest WdfRequestCancelSentRequest 方法尝试取消调用方以前提交到 I/O 目标的 I/O 请求。
WdfRequestChangeTarget WdfRequestChangeTarget 方法验证指定的 I/O 请求是否可以发送到指定的 I/O 目标。
WdfRequestComplete WdfRequestComplete 方法完成指定的 I/O 请求并提供完成状态。
WdfRequestCompleteWithInformation WdfRequestCompleteWithInformation 方法存储完成信息，然后使用提供的完成状态完成指定的 I/O 请求。
WdfRequestCompleteWithPriorityBoost WdfRequestCompleteWithPriorityBoost 方法完成指定的 I/O 请求并提供完成状态。 它还指定一个值，系统可以使用该值来提升请求 I/O 操作的线程的运行时优先级。
WdfRequestCreate WdfRequestCreate 方法创建一个空的框架请求对象。
WdfRequestCreateFromIrp WdfRequestCreateFromIrp 方法从指定的 WDM IRP 创建框架请求对象。
WdfRequestFormatRequestUsingCurrentType WdfRequestFormatRequestUsingCurrentType 方法格式化指定的 I/O 请求，以便驱动程序可以将其转发到驱动程序的本地 I/O 目标（未经修改）。
WdfRequestForwardToIoQueue WdfRequestForwardToIoQueue 方法将 I/O 请求重新排队到调用驱动程序的 I/O 队列之一。
WdfRequestForwardToParentDeviceIoQueue WdfRequestForwardToParentDeviceIoQueue 方法将子设备的 I/O 队列中的 I/O 请求重新排队到子设备的父设备的指定 I/O 队列。
WdfRequestGetCompletionParams WdfRequestGetCompletionParams 方法检索与指定框架请求对象关联的 I/O 完成参数。
WdfRequestGetEffectiveIoType WdfRequestGetEffectiveIoType 方法返回 UMDF 用于指定 I/O 请求的数据缓冲区的缓冲区访问方法。
WdfRequestGetFileObject WdfRequestGetFileObject 方法检索与指定 I/O 请求关联的框架文件对象。
WdfRequestGetInformation WdfRequestGetInformation 方法返回指定 I/O 请求的完成状态信息。
WdfRequestGetIoQueue WdfRequestGetIoQueue 方法返回从中传递指定 I/O 请求的框架队列对象的句柄。
WdfRequestGetParameters WdfRequestGetParameters 方法检索与指定框架请求对象关联的参数。
WdfRequestGetRequestorMode WdfRequestGetRequestorMode 方法返回指定 I/O 请求的发起者的处理器访问模式。
WdfRequestGetRequestorProcessId WdfRequestGetRequestorProcessId 方法检索发送 I/O 请求的进程标识符。
WdfRequestGetStatus WdfRequestGetStatus 方法返回 I/O 请求的状态。
WdfRequestGetUserModeDriverInitiatedIo WdfRequestGetUserModeDriverInitiatedIo 方法确定是否将 I/O 请求标记为由 UMDF 驱动程序启动。
WdfRequestImpersonate WdfRequestImpersonate 方法注册驱动程序提供的事件回调函数，框架应调用该函数进行模拟。
WdfRequestIsCanceled WdfRequestIsCanceled 方法确定 I/O 管理器是否已尝试取消指定的 I/O 请求。
WdfRequestIsFrom32BitProcess WdfRequestIsFrom32BitProcess 方法检查指定 I/O 请求的发起方是否为 32 位用户模式应用程序。
WdfRequestIsFromUserModeDriver WdfRequestIsFromUserModeDriver 方法指示 I/O 请求来自用户模式驱动程序还是来自应用程序。
WdfRequestIsReserved WdfRequestIsReserved 方法确定指定的请求对象是否是框架为在内存不足的情况下支持有保证的向前进度而保留的请求对象。
WdfRequestMarkCancelable WdfRequestMarkCancelable 方法允许取消指定的 I/O 请求。
WdfRequestMarkCancelableEx WdfRequestMarkCancelableEx 方法允许取消指定的 I/O 请求。
WdfRequestProbeAndLockUserBufferForRead WdfRequestProbeAndLockUserBufferForRead 方法验证 I/O 请求的用户模式缓冲区是否可读，然后锁定缓冲区的物理内存页，以便驱动程序堆栈中的驱动程序可以读取缓冲区。
WdfRequestProbeAndLockUserBufferForWrite WdfRequestProbeAndLockUserBufferForWrite 方法验证 I/O 请求的用户模式缓冲区是否可写，然后锁定缓冲区的物理内存页，以便驱动程序堆栈中的驱动程序可以写入缓冲区。
WdfRequestRequeue WdfRequestRequeue 方法将 I/O 请求返回到从该请求传递到驱动程序的 I/O 队列的头。
WdfRequestRetrieveActivityId WdfRequestRetrieveActivityId 方法检索与 I/O 请求关联的当前活动标识符。
WdfRequestRetrieveInputBuffer WdfRequestRetrieveInputBuffer 方法检索 I/O 请求的输入缓冲区。
WdfRequestRetrieveInputMemory WdfRequestRetrieveInputMemory 方法检索表示 I/O 请求输入缓冲区的框架内存对象的句柄。
WdfRequestRetrieveInputWdmMdl WdfRequestRetrieveInputWdmMdl 方法 (表示 I/O 请求输入缓冲区的 MDL) 检索内存描述符列表。
WdfRequestRetrieveOutputBuffer WdfRequestRetrieveOutputBuffer 方法检索 I/O 请求的输出缓冲区。
WdfRequestRetrieveOutputMemory WdfRequestRetrieveOutputMemory 方法检索表示 I/O 请求输出缓冲区的框架内存对象的句柄。
WdfRequestRetrieveOutputWdmMdl WdfRequestRetrieveOutputWdmMdl 方法 (表示 I/O 请求输出缓冲区的 MDL) 检索内存描述符列表。
WdfRequestRetrieveUnsafeUserInputBuffer 如果请求访问数据缓冲区的技术既不是缓冲的，也不是直接 I/O，WdfRequestRetrieveUnsafeUserInputBuffer 方法将检索 I/O 请求的输入缓冲区。
WdfRequestRetrieveUnsafeUserOutputBuffer 如果请求访问数据缓冲区的技术既不是缓冲的，也不是直接 I/O，WdfRequestRetrieveUnsafeUserOutputBuffer 方法将检索 I/O 请求的输出缓冲区。
WdfRequestReuse WdfRequestReuse 方法重新初始化框架请求对象，以便可以重用它。
WdfRequestSend WdfRequestSend 方法将指定的 I/O 请求发送到指定的 I/O 目标。
WdfRequestSetActivityId WdfRequestSetActivityId 方法将活动标识符与 I/O 请求相关联。
WdfRequestSetCompletionRoutine WdfRequestSetCompletionRoutine 方法为指定的框架请求对象注册或取消注册完成例程。
WdfRequestSetInformation WdfRequestSetInformation 方法为指定的 I/O 请求设置完成状态信息。
WdfRequestSetUserModeDriverInitiatedIo WdfRequestSetUserModeDriverInitiatedIo 方法向位于同一设备堆栈中的 UMDF 驱动程序下面的内核模式驱动程序指示，应将特定请求视为来自 UMDF 驱动程序。
WdfRequestStopAcknowledge WdfRequestStopAcknowledge 方法通知框架驱动程序已停止处理指定的 I/O 请求。
WdfRequestUnmarkCancelable WdfRequestUnmarkCancelable 方法禁用取消指定的 I/O 请求。
WdfRequestWdmFormatUsingStackLocation WdfRequestWdmFormatUsingStackLocation 方法通过将指定 WDM I/O 堆栈位置结构的内容复制到请求中的下一个堆栈位置来格式化 I/O 请求。
WdfRequestWdmGetIrp WdfRequestWdmGetIrp 方法返回与指定框架请求对象关联的 WDM IRP 结构。

回调函数

EVT_WDF_REQUEST_CANCEL 驱动程序的 EvtRequestCancel 事件回调函数处理在取消 I/O 请求时必须执行的操作。
EVT_WDF_REQUEST_COMPLETION_ROUTINE 当另一个驱动程序完成指定的 I/O 请求时，驱动程序的 CompletionRoutine 事件回调函数将执行。
EVT_WDF_REQUEST_IMPERSONATE 驱动程序的 EvtRequestImpersonate 事件回调函数在请求的模拟级别执行任务，例如打开受保护的文件。

结构

WDF_REQUEST_COMPLETION_PARAMS WDF_REQUEST_COMPLETION_PARAMS 结构包含与 I/O 请求完成相关的参数。
WDF_REQUEST_FORWARD_OPTIONS WDF_REQUEST_FORWARD_OPTIONS 结构包含用于将 I/O 请求从子设备的 I/O 队列重新排队到父设备的 I/O 队列的选项。
WDF_REQUEST_PARAMETERS WDF_REQUEST_PARAMETERS 结构接收与 I/O 请求关联的参数。
WDF_REQUEST_REUSE_PARAMS WDF_REQUEST_REUSE_PARAMS结构指定与重复使用的 I/O 请求关联的信息。
WDF_REQUEST_SEND_OPTIONS WDF_REQUEST_SEND_OPTIONS结构指定与将 I/O 请求发送到 I/O 目标关联的选项。

枚举

WDF_REQUEST_FORWARD_OPTIONS_FLAGS WDF_REQUEST_FORWARD_OPTIONS_FLAGS 枚举类型定义在驱动程序WDF_REQUEST_FORWARD_OPTIONS结构中使用的标志。
WDF_REQUEST_REUSE_FLAGS WDF_REQUEST_REUSE_FLAGS 枚举类型定义在驱动程序WDF_REQUEST_REUSE_PARAMS结构中使用的标志。
WDF_REQUEST_SEND_OPTIONS_FLAGS WDF_REQUEST_SEND_OPTIONS_FLAGS 枚举类型定义在驱动程序WDF_REQUEST_SEND_OPTIONS结构中使用的标志。
WDF_REQUEST_STOP_ACTION_FLAGS WDF_REQUEST_STOP_ACTION_FLAGS 枚举类型定义框架传递给驱动程序的 EvtIoStop 回调函数的标志。
WDF_REQUEST_TYPE WDF_REQUEST_TYPE枚举类型标识框架请求对象可能包含的请求类型。