Função RxAcquireExclusiveFcbResourceInMRx (mrxfcb.h)

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.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho mrxfcb.h (inclua Mrxfcb.h)
IRQL <= APC_LEVEL

Confira também

RxAcquireSharedFcbResourceInMRx

RxAcquireSharedFcbResourceInMRxEx

RxReleaseFcbResourceForThreadInMRx

RxReleaseFcbResourceInMRx