RxpAcquirePrefixTableLockExclusive function

RxpAcquirePrefixTableLockExclusive acquires the prefix table lock exclusively.

Syntax

BOOLEAN RxpAcquirePrefixTableLockExclusive(
  PRX_PREFIX_TABLE pTable,
  BOOLEAN          Wait,
  BOOLEAN          ProcessBufferingStateChangeRequests,
  PSZ              FileName,
  ULONG            LineNumber
);

Parameters

pTable

A pointer to the RX_PREFIX_TABLE where the lock will be acquired.

Wait

A Boolean value that specifies the behavior whenever the resource cannot be acquired immediately. If TRUE, the caller is put into a wait state until the resource can be acquired. If FALSE, the routine immediately returns, whether the resource can be acquired.

ProcessBufferingStateChangeRequests

TBD

FileName

TBD

LineNumber

TBD

Return Value

RxpAcquirePrefixTableLockExclusive returns TRUE if the resource is acquired. This routine returns FALSE if the input Wait is FALSE and exclusive access cannot be granted immediately.

Remarks

The RxAcquirePrefixTableLockExclusive routine is implemented as a macro on Windows Server 2003. On Windows XP and Windows 2000, RxAcquirePrefixTableLockExclusive is implemented as a routine.

The RxAcquirePrefixTableLockExclusive macro calls the RxpAcquirePrefixTableLockExclusive routine. The RxIsPrefixTableLockExclusive macro can be used to determine if an exclusive prefix table lock was previously acquired. The RxIsPrefixTableLockAcquired macro can also be used to determine if either an exclusive or shared prefix table lock was previously acquired.

Normal kernel APC delivery should be disabled before calling this routine. Disable normal kernel APC delivery by calling FsRtlEnterFileSystem or KeEnterCriticalRegion. Delivery must remain disabled until the resource is released, at which point it can be reenabled by calling FsRtlExitFileSystem or KeLeaveCriticalRegion.

Requirements

   
Target Platform Desktop
Header prefix.h (include Prefix.h)
IRQL "<= APC_LEVEL"

See Also

FsRtlEnterFileSystem

FsRtlExitFileSystem

KeEnterCriticalRegion

KeLeaveCriticalRegion

RxPrefixTableLookupName

RxpAcquirePrefixTableLockShared

RxpReleasePrefixTableLock