共用方式為

WdfRequestFormatRequestUsingCurrentType 函式 （wdfrequest.h）

  • 發行項

[適用於 KMDF 和 UMDF]

WdfRequestFormatRequestUsingCurrentType 方法會將指定的 I/O 要求格式化，讓驅動程式 轉送至驅動程式的本機 I/O 目標。

語法

void WdfRequestFormatRequestUsingCurrentType(
  [in] WDFREQUEST Request
);

參數

[in] Request

驅動程式從其中一個 I/O 佇列接收之架構要求物件的句柄。

傳回值

沒有

言論

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

當驅動程式 收到 I/O 要求時，有時候您會希望驅動程式將要求轉送至其本機 I/O 目標。 若要轉送這類要求，驅動程序必須：

  1. 呼叫 WdfRequestFormatRequestUsingCurrentType 來格式化要求物件，讓架構可以將要求傳遞至驅動程式的本機 I/O 目標。
  2. 呼叫 WdfRequestSend，將要求傳送至 I/O 目標。
如需 WdfRequestFormatRequestUsingCurrentType的詳細資訊，請參閱 轉送 I/O 要求。

例子

下列程式代碼範例是 EvtIoDefault 回呼函式，它會將它收到的每個 I/O 要求轉送至裝置的本機 I/O 目標。

VOID
MyEvtIoDefault(
    WDFQUEUE Queue,
    WDFREQUEST Request
    )
{
    WDF_REQUEST_SEND_OPTIONS options;
    NTSTATUS status;

    WdfRequestFormatRequestUsingCurrentType(Request);

    WDF_REQUEST_SEND_OPTIONS_INIT(
                                  &options,
                                  WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET
                                  );

    ret = WdfRequestSend (
                          Request,
                          WdfDeviceGetIoTarget(WdfIoQueueGetDevice(Queue)),
                          &options
                          );
    if (!ret) {
        status = WdfRequestGetStatus(Request);
        WdfRequestComplete(
                           Request,
                           status
                           );
    }
    return;
}

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
標頭 wdfrequest.h （包括 Wdf.h）
連結庫 Wdf01000.sys （KMDF）：WUDFx02000.dll （UMDF）
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 DriverCreate（kmdf），InvalidReqAccess（kmdf），InvalidReqAccessLocal（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf），RequestFormattedValid（kmdf）

另請參閱

WdfRequestSend

WdfRequestWdmFormatUsingStackLocation