функция WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP (wdfrequest.h)

Статья
02/07/2025

[Применимо к KMDF и UMDF]

Функция WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP задает новый IRP в WDF_REQUEST_REUSE_PARAMS структуре драйвера.

Синтаксис

void WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP(
  [in, out] PWDF_REQUEST_REUSE_PARAMS Params,
  [in]      PIRP                      NewIrp
);

Параметры

[in, out] Params

Указатель на структуру, предоставляемую вызывающим WDF_REQUEST_REUSE_PARAMS.

[in] NewIrp

Указатель на указанную вызывающим структуру IRP.

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

Никакой

Замечания

Если вызов драйвера WdfRequestRequestReuse задает новую структуру IRP, драйвер должен сначала вызвать WDF_REQUEST_REUSE_PARAMS_INIT, а затем вызвать WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP, чтобы инициализировать структуру WDF_REQUEST_REUSE_PARAMS.

Функция WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP задает элемент NewIrp структуры указанному указателю IRP. Он также задает флаг WDF_REQUEST_REUSE_SET_NEW_IRPв элементе флага структуры.

Примеры

Следующий пример кода инициализирует структуру WDF_REQUEST_REUSE_PARAMS, предоставляет новую структуру IRP для запроса ввода-вывода, а затем вызывает WdfRequestRequestReuse.

WDF_REQUEST_REUSE_PARAMS  params;
NTSTATUS  status;
PIRP  myIrp;
...
WDF_REQUEST_REUSE_PARAMS_INIT(
                              &params,
                              WDF_REQUEST_REUSE_NO_FLAGS,
                              STATUS_SUCCESS
                              );
WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP(
                                     &params,
                                     myIrp
                                     );
status = WdfRequestReuse(
                         Request,
                         &params
                         );
...

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfrequest.h (включая Wdf.h)

См. также

WDF_REQUEST_REUSE_PARAMS

WDF_REQUEST_REUSE_PARAMS_INIT

WdfRequestReuse

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