此标头由 wdf 使用。 有关详细信息,请参阅:
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枚举类型标识框架请求对象可能包含的请求类型。 |