PMRX_IS_LOCK_REALIZABLE fonction de rappel (mrx.h)

Article
02/07/2025

La routine MRxIsLockRealizable est appelée par RDBSS pour demander qu’un mini-redirecteur réseau indique si un verrou de plage d’octets spécifique est pris en charge sur cette structure NET_ROOT.

Syntaxe

PMRX_IS_LOCK_REALIZABLE PmrxIsLockRealizable;

NTSTATUS PmrxIsLockRealizable(
  IN OUT PMRX_FCB Fcb,
  IN PLARGE_INTEGER ByteOffset,
  IN PLARGE_INTEGER Length,
  IN ULONG LowIoLockFlags
)
{...}

Paramètres

Fcb

[in, out] Pointeur vers la structure FCB.

ByteOffset

[in] Valeur indiquant le décalage d’octet pour le verrou de plage d’octets.

Length

[in] Valeur indiquant la longueur du verrou de plage d’octets.

LowIoLockFlags

[in] Valeur avec masque de bits indiquant les indicateurs de verrouillage d’E/S.

Valeur de retour

MRxIsLockRealizable retourne STATUS_SUCCESS sur la réussite ou une valeur NTSTATUS appropriée, par exemple :

Retourner le code	Description
STATUS_NOT_SUPPORTED	Le verrou de plage d’octets demandé n’est pas pris en charge. Un mini-redirecteur réseau retourne cette valeur pour une demande de verrou qui n’est pas prise en charge même si d’autres types de verrous de plage d’octets sont pris en charge. Les verrous non pris en charge peuvent inclure des verrous 64 bits (le ByteOffset->membre HighPart n’est pas égal à zéro), les verrous de longueur nulle (le paramètre Length est égal à zéro) ou les verrous partagés (le bit LOWIO_LOCKSFLAG_EXCLUSIVELOCK du paramètre LowIoLockFlags n’est pas défini).

Retourner le code

Description

STATUS_NOT_SUPPORTED

Le verrou de plage d’octets demandé n’est pas pris en charge. Un mini-redirecteur réseau retourne cette valeur pour une demande de verrou qui n’est pas prise en charge même si d’autres types de verrous de plage d’octets sont pris en charge. Les verrous non pris en charge peuvent inclure des verrous 64 bits (le ByteOffset->membre HighPart n’est pas égal à zéro), les verrous de longueur nulle (le paramètre Length est égal à zéro) ou les verrous partagés (le bit LOWIO_LOCKSFLAG_EXCLUSIVELOCK du paramètre LowIoLockFlags n’est pas défini).

Remarques

MRxIsLockRealizable détermine si le verrou de plage d’octets demandé est pris en charge sur cette structure NET_ROOT. Un mini-redirecteur réseau peut prendre en charge certains verrous de plage d’octets et ne pas prendre en charge d’autres utilisateurs. Par exemple, un mini-redirecteur réseau peut uniquement prendre en charge les verrous de plage d’octets 32 bits ou les verrous exclusifs.

MRxIsLockRealizable est appelé en réponse à la réception d’un IRP avec la fonction mineure IRP_MN_LOCK.