Функция RxCreateRxContext (rxcontx.h)
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 была выделена из памяти нестраничного пула.
Требования
Требование | Значение |
---|---|
Целевая платформа | Персональный компьютер |
Верхняя часть | rxcontx.h (включая Rxprocs.h rxcontx.h) |
IRQL | <= APC_LEVEL |
См. также раздел
RxDereferenceAndDeleteRxContext_Real
RxResumeBlockedOperations_Serially