Função RxAcquireSharedFcbResourceInMRx (mrxfcb.h)

Artigo
02/26/2024

RxAcquireSharedFcbResourceInMRx adquire o recurso FCB para um driver de minidiretório de rede no modo compartilhado. Essa rotina aguardará que o recurso fcb seja gratuito se ele tiver sido adquirido exclusivamente anteriormente e não retornará o controle até que o recurso compartilhado seja adquirido.

Sintaxe

NTSTATUS RxAcquireSharedFcbResourceInMRx(
  PMRX_FCB Fcb
);

Parâmetros

Fcb

Um ponteiro para o FCB. Esse parâmetro é necessário e não pode ser NULL.

Retornar valor

RxAcquireSharedFcbResourceInMRx retorna STATUS_SUCCESS com êxito ou um dos seguintes códigos de erro em caso de falha:

Código de retorno	Descrição
STATUS_LOCK_NOT_GRANTED	O recurso FCB não foi adquirido.
STATUS_CANCELLED	O RX_CONTEXT associado ao FCB foi cancelado.

Comentários

Os recursos de sincronização de interesse para um driver de minidiretório de rede são associados principalmente ao FCB. Há um recurso de E/S de paginação e um recurso regular. O recurso de E/S de paginação é gerenciado internamente pelo RDBSS. O único recurso acessível a um driver de minidiretório de rede é o recurso regular que deve ser acessado usando RxAcquireExclusiveFcbResourceInMRx, RxAcquireExclusiveFcbResourceInMRxEx ou RxAcquireSharedFcbResourceInMRx, dependendo do modo adquirido desejado.

RxAcquireSharedFcbResourceInMRx aguardará a liberação do recurso FCB se ele tiver sido adquirido exclusivamente e não retornará o controle até que o recurso compartilhado seja adquirido. Essa rotina adquire o recurso FCB mesmo que o RX_CONTEXT associado a esse FCB tenha sido cancelado.

Um recurso fcb adquirido com RxAcquireSharedFcbResourceInMRx deve ser liberado chamando RxReleaseFcbResourceInMRx ou RxReleaseFcbResourceForThreadInMRx.