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

Статья
02/07/2025

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 на ошибку.

Замечания

RxCreateRxContext вызывает RxInitializeContext, чтобы инициализировать только что созданную структуру RX_CONTEXT перед возвратом.

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

Если задано это значение, структура RX_CONTEXT была выделена из памяти нестраничного пула.