Gerenciamento de RX_CONTEXT e IRP

A estrutura RX_CONTEXT é uma das estruturas de dados fundamentais usadas por RDBSS e minidiretórios de rede para gerenciar um IRP (pacote de solicitação de E/S). Uma estrutura RX_CONTEXT descreve um IRP enquanto ele está sendo processado e contém informações de estado que permitem que os recursos globais sejam liberados à medida que o IRP é concluído. A estrutura de dados RX_CONTEXT encapsula um IRP para uso por RDBSS, minidiretórios de rede e pelo sistema de arquivos. Uma estrutura RX_CONTEXT inclui um ponteiro para um único IRP e todo o contexto necessário para processar o IRP.

Uma estrutura de RX_CONTEXT às vezes é conhecida como um Contexto IRP ou RxContext nos arquivos de cabeçalho do WDK (Windows Driver Kit) e outros recursos usados para desenvolver drivers de minidiretório de rede.

O RX_CONTEXT é uma estrutura de dados à qual informações adicionais fornecidas pelos vários minidiretórios de rede são anexadas. Do ponto de vista do design, essas informações adicionais podem ser tratadas de várias maneiras:

• Permitir que ponteiros de contexto sejam definidos como parte de RX_CONTEXT, que os minidiretórios de rede usam para armazenar suas informações. Isso implica que sempre que uma estrutura de RX_CONTEXT é alocada e destruída, o driver de minidiretório de rede deve executar uma alocação ou destruição associada separada do bloco de memória que contém as informações adicionais de minidiretório de rede. Como RX_CONTEXT estruturas são criadas e destruídas em grande número, essa não é uma solução aceitável do ponto de vista do desempenho.

• Outra abordagem consiste em alocar o tamanho de cada estrutura RX_CONTEXT por um valor pré-especificado para cada minidiretório de rede, que é então reservado para uso pelo minidiretório. Essa abordagem evita a alocação e a destruição adicionais, mas complica o código de gerenciamento de RX_CONTEXT no RDBSS.

• A terceira abordagem consiste em alocar uma área pré-especificada, que é a mesma para todos os minidiretórios de rede como parte de cada RX_CONTEXT. Essa é uma área não formatado sobre a qual qualquer estrutura desejada pode ser imposta pelos vários minidiretórios de rede. Essa abordagem supera as desvantagens associadas às abordagens anteriores. Essa é a abordagem atualmente implementada no RDBSS.

A terceira abordagem é o esquema usado pelo RDBSS. Consequentemente, os desenvolvedores de drivers de minidiretório de rede devem tentar definir o contexto privado associado para se ajustar a essa área pré-especificada definida na estrutura de dados RX_CONTEXT. Os drivers de minidiretório de rede que violam essa regra incorrerão em uma penalidade significativa de desempenho.

Muitas rotinas e rotinas rdbss exportadas por um minidiretório de rede fazem referência a estruturas de RX_CONTEXT no thread inicial ou em algum outro thread usado pela rotina. Assim, as estruturas de RX_CONTEXT são contadas para gerenciar seu uso para operações assíncronas. Quando a contagem de referência vai para zero, a estrutura RX_CONTEXT pode ser finalizada e liberada na última operação de desreferência.

O RDBSS fornece várias rotinas usadas para manipular uma estrutura RX_CONTEXT e o IRP associado. Essas rotinas são usadas para alocar, inicializar e excluir uma estrutura RX_CONTEXT. Essas rotinas também são usadas para concluir o IRP associado a um RX_CONTEXT e configurar uma rotina de cancelamento para um RX_CONTEXT.

As seguintes rotinas manipulam estruturas RX_CONTEXT:

As macros a seguir são definidas no arquivo de cabeçalho rxcontx.h que chama as rotinas listadas na tabela anterior. Normalmente, essas macros são usadas em vez de chamar essas rotinas diretamente.