Função RxAcquireSharedFcbResourceInMRx (mrxfcb.h)

Artigo
02/07/2025

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 foi adquirido exclusivamente anteriormente e não retornará o controle até que o recurso compartilhado tenha sido adquirido.

Sintaxe

NTSTATUS RxAcquireSharedFcbResourceInMRx(
  PMRX_FCB Fcb
);

Parâmetros

Fcb

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

Valor de retorno

RxAcquireSharedFcbResourceInMRx retorna STATUS_SUCCESS com êxito ou um dos seguintes códigos de erro sobre 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.

Observações

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, RxAcquireExclusiveFcbResourceInMRxExou RxAcquireSharedFcbResourceInMRx, dependendo do modo adquirido desejado.

RxAcquireSharedFcbResourceInMRx aguardará que o recurso FCB seja gratuito se ele foi adquirido exclusivamente anteriormente e não retornará o controle até que o recurso compartilhado seja adquirido. Essa rotina adquire o recurso fcb mesmo que a RX_CONTEXT associada a essa FCB tenha sido cancelada.

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