Funzione RxAcquireSharedFcbResourceInMRxEx (mrxfcb.h)

RxAcquireSharedFcbResourceInMRxEx acquisisce la risorsa FCB per un driver mini-redirector di rete in modalità condivisa. Questa routine attenderà che la risorsa FCB sia libera se è stata acquisita in precedenza esclusivamente e non restituisce il controllo fino a quando non viene acquisita la risorsa condivisa.

Sintassi

NTSTATUS RxAcquireSharedFcbResourceInMRxEx(
  [in] IN PRX_CONTEXT pRxContext,
       PMRX_FCB       Fcb
);

Parametri

[in] pRxContext

Puntatore al RX_CONTEXT. Questo parametro fornisce il contesto dell'operazione per un trattamento speciale da parte del rilevamento RDBSS interno, se questa funzionalità è abilitata.

Fcb

Puntatore al cluster di failover. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

RxAcquireSharedFcbResourceInMRxEx restituisce STATUS_SUCCESS in caso di esito positivo o uno dei codici di errore seguenti in caso di errore:

Codice restituito Descrizione
STATUS_LOCK_NOT_GRANTED
La risorsa FCB non è stata acquisita.
STATUS_CANCELLED
Il RX_CONTEXT associato al cluster di failover è stato annullato.

Commenti

Le risorse di sincronizzazione di interesse per un driver mini-redirector di rete sono principalmente associate al cluster di failover. È presente una risorsa di I/O di paging e una risorsa normale. La risorsa di I/O di paging viene gestita internamente da RDBSS. L'unica risorsa accessibile a un driver mini-redirector di rete è la risorsa regolare a cui accedere usando RxAcquireExclusiveFcbResourceInMRx, RxAcquireExclusiveFcbResourceInMRxEx o RxAcquireSharedFcbResourceInMRx, a seconda della modalità acquisita desiderata.

RxAcquireSharedFcbResourceInMRxEx attenderà che la risorsa FCB sia libera se è stata acquisita in precedenza esclusivamente e non restituisce il controllo finché non viene acquisita la risorsa condivisa. Questa routine acquisisce la risorsa fcb anche se il RX_CONTEXT associato a tale fcb è stato annullato.

Una risorsa FCB acquisita con RxAcquireSharedFcbResourceInMRxEx deve essere rilasciata chiamando RxReleaseFcbResourceInMRx o RxReleaseFcbResourceForThreadInMRx.

Requisiti

Requisito Valore
Client minimo supportato La routine RxAcquireSharedFcbResourceInMRxEx è disponibile solo in Windows Server 2003 Service Pack 1 e versioni successive.
Piattaforma di destinazione Desktop
Intestazione mrxfcb.h (include Mrxfcb.h)
IRQL <= APC_LEVEL

Vedi anche

RxAcquireExclusiveFcbResourceInMRx

RxAcquireSharedFcbResourceInMRx

RxReleaseFcbResourceForThreadInMRx

RxReleaseFcbResourceInMRx