Função RxCreateRxContext (rxcontx.h)

Artigo
02/26/2024

RxCreateRxContext aloca uma nova estrutura de RX_CONTEXT e inicializa a estrutura de dados.

Sintaxe

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

Parâmetros

[in, optional] Irp

Um ponteiro para o IRP a ser encapsulado por essa estrutura RX_CONTEXT.

[in] RxDeviceObject

Um ponteiro para o objeto de dispositivo ao qual esse RX_CONTEXT e IRP se aplicam.

[in] InitialContextFlags

O conjunto de valores iniciais para o membro Flags da estrutura de dados RX_CONTEXT a ser armazenado na estrutura RX_CONTEXT. Esses valores iniciais podem ser qualquer combinação das seguintes enumerações:

RX_CONTEXT_FLAG_WAIT

Quando esse valor é definido, o IRP não deve ser postado para execução posterior pelo processo do sistema de arquivos, mas deve ser aguardado para ser concluído.

RX_CONTEXT_FLAG_MUST_SUCCEED

Quando esse valor é definido, a operação deve ser bem-sucedida. Esse valor não é usado atualmente pelo RDBSS, mas pode ser usado por drivers de minidiretório de rede.

RX_CONTEXT_FLAG_MUST_SUCCEED_NONBLOCKING

Quando esse valor é definido, a operação deve ter êxito para operações sem bloqueio. Esse valor não é usado atualmente pelo RDBSS, mas pode ser usado por drivers de minidiretório de rede.

Retornar valor

RxCreateRxContext retorna um ponteiro para uma estrutura de dados de RX_CONTEXT alocada com êxito ou um ponteiro NULL sobre falha.

Comentários

RxCreateRxContext chama RxInitializeContext para inicializar a estrutura de RX_CONTEXT recém-criada antes de retornar.

RxCreateRxContext aloca memória de pool não paginada ao criar uma nova estrutura de dados RX_CONTEXT e define o seguinte valor no membro Flags do RX_CONTEXT:

Quando esse valor é definido, a estrutura RX_CONTEXT foi alocada da memória do pool não paginada.