Функция WdfRequestFormatRequestUsingCurrentType (wdfrequest.h)

Статья
10/01/2024

[Относится к KMDF и UMDF]

Метод WdfRequestFormatRequestUsingCurrentType форматирует указанный запрос ввода-вывода, чтобы драйвер без изменений перенаправил его в локальный целевой объект ввода-вывода драйвера.

Синтаксис

void WdfRequestFormatRequestUsingCurrentType(
  [in] WDFREQUEST Request
);

Параметры

[in] Request

Дескриптор объекта запроса платформы, который драйвер получил из одной из своих очередей ввода-вывода.

Возвращаемое значение

None

Remarks

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Когда драйвер получает запрос ввода-вывода, иногда требуется, чтобы драйвер перенаправил запрос без изменений в локальный целевой объект ввода-вывода. Чтобы переслать такой запрос, драйвер должен:

Вызовите WdfRequestFormatRequestUsingCurrentType , чтобы отформатировать объект запроса таким образом, чтобы платформа вела передачу запроса локальному целевому объекту ввода-вывода драйвера.
Вызовите WdfRequestSend , чтобы отправить запрос целевому объекту ввода-вывода.

Дополнительные сведения о WdfRequestFormatRequestUsingCurrentType см. в разделе Пересылка запросов ввода-вывода.

Примеры

В следующем примере кода показана функция обратного вызова EvtIoDefault , которая пересылает каждый получаемый запрос ввода-вывода без изменений в локальный целевой объект ввода-вывода устройства.

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

Поделиться через