Функция RxCreateRxContext (rxcontx.h)

Статья
08/07/2023

RxCreateRxContext выделяет новую структуру RX_CONTEXT и инициализирует структуру данных.

Синтаксис

PRX_CONTEXT RxCreateRxContext(
  [in, optional] IN PIRP                 Irp,
  [in]           IN PRDBSS_DEVICE_OBJECT RxDeviceObject,
  [in]           IN ULONG                InitialContextFlags
);

Параметры

[in, optional] Irp

Указатель на IRP, инкапсулированный этой структурой RX_CONTEXT.

[in] RxDeviceObject

Указатель на объект устройства, к которому применяется это RX_CONTEXT и IRP.

[in] InitialContextFlags

Набор начальных значений для элемента Flags RX_CONTEXT структуры данных, хранимой в RX_CONTEXT структуре. Эти начальные значения могут быть любым сочетанием следующих перечислений:

RX_CONTEXT_FLAG_WAIT

Если это значение задано, IRP не следует отправлять для последующего выполнения процессом файловой системы, а ожидать завершения.

RX_CONTEXT_FLAG_MUST_SUCCEED

Если это значение задано, операция должна завершиться успешно. Это значение в настоящее время не используется RDBSS, но может использоваться драйверами сетевого мини-перенаправления.

RX_CONTEXT_FLAG_MUST_SUCCEED_NONBLOCKING

Если это значение задано, операция должна быть успешной для неблокирующих операций. Это значение в настоящее время не используется RDBSS, но может использоваться драйверами сетевого мини-перенаправления.

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

RxCreateRxContext возвращает указатель на выделенную RX_CONTEXT структуру данных об успешном выполнении или указатель NULL при сбое.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	rxcontx.h (включая Rxprocs.h rxcontx.h)
IRQL	<= APC_LEVEL