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 方法會擷取記憶體描述項清單， (MDL) ，代表 I/O 要求的輸入緩衝區。
WdfRequestRetrieveOutputBuffer WdfRequestRetrieveOutputBuffer 方法會擷取 I/O 要求的輸出緩衝區。
WdfRequestRetrieveOutputMemory WdfRequestRetrieveOutputMemory 方法會擷取架構記憶體物件的控制碼，該物件代表 I/O 要求的輸出緩衝區。
WdfRequestRetrieveOutputWdmMdl WdfRequestRetrieveOutputWdmMdl 方法會擷取記憶體描述元清單 (MDL) ，代表 I/O 要求的輸出緩衝區。
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列舉型別可識別架構要求物件可能包含的要求類型。