Función RxCreateRxContext (rxcontx.h)

Artículo
08/07/2023

RxCreateRxContext asigna una nueva estructura de RX_CONTEXT e inicializa la estructura de datos.

Sintaxis

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

Parámetros

[in, optional] Irp

Puntero al IRP que va a encapsular esta estructura RX_CONTEXT.

[in] RxDeviceObject

Puntero al objeto de dispositivo al que se aplica este RX_CONTEXT e IRP.

[in] InitialContextFlags

Conjunto de valores iniciales para el miembro Flags de la estructura de datos RX_CONTEXT que se almacenará en la estructura RX_CONTEXT. Estos valores iniciales pueden ser cualquier combinación de las enumeraciones siguientes:

RX_CONTEXT_FLAG_WAIT

Cuando se establece este valor, el proceso del sistema de archivos no debe publicar el IRP para su ejecución posterior, pero debe esperar a que se complete.

RX_CONTEXT_FLAG_MUST_SUCCEED

Cuando se establece este valor, la operación debe realizarse correctamente. RdBSS no usa actualmente este valor, pero los controladores de minidirector de red pueden usarlo.

RX_CONTEXT_FLAG_MUST_SUCCEED_NONBLOCKING

Cuando se establece este valor, la operación debe realizarse correctamente para las operaciones sin bloqueo. RdBSS no usa actualmente este valor, pero los controladores de minidirector de red pueden usarlo.

Valor devuelto

RxCreateRxContext devuelve un puntero a una estructura de datos RX_CONTEXT asignada si se ejecuta correctamente o un puntero NULL en caso de error.

Comentarios

RxCreateRxContext llama a RxInitializeContext para inicializar la estructura de RX_CONTEXT recién creada antes de devolver.

RxCreateRxContext asigna memoria de grupo no paginada al crear una nueva estructura de datos RX_CONTEXT y establece el siguiente valor en el miembro Flags del RX_CONTEXT:

Cuando se establece este valor, la estructura RX_CONTEXT se asignó desde la memoria del grupo no paginado.