Função RxAcquireExclusiveFcbResourceInMRx (mrxfcb.h)

Artigo
03/01/2024

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

Sintaxe

NTSTATUS RxAcquireExclusiveFcbResourceInMRx(
  PMRX_FCB Fcb
);

Parâmetros

Fcb

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

Retornar valor

RxAcquireExclusiveFcbResourceInMRx 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.

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 para um driver de minidiretório de rede é o recurso regular que deve ser acessado usando RxAcquireExclusiveFcbResourceInMRx, RxAcquireExclusiveFcbResourceInMRxEx ou RxAcquireSharedFcbResourceInMRx, dependendo do modo adquirido desejado.

RxAcquireExclusiveFcbResourceInMRx aguardará a liberação do recurso FCB se ele tiver sido adquirido anteriormente e não retornará o controle até que o recurso exclusivo 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 RxAcquireExclusiveFcbResourceInMRx deve ser liberado chamando RxReleaseFcbResourceInMRx ou RxReleaseFcbResourceForThreadInMRx.