RxCreateSrvOpen, fonction (fcb.h)

Article
02/29/2024

RxCreateSrvOpen alloue, initialise et insère une nouvelle structure SRV_OPEN dans les structures de données en mémoire utilisées par rdBSS. Si une nouvelle structure doit être allouée, elle dispose d’un espace pour une structure FOBX.

Syntaxe

PSRV_OPEN RxCreateSrvOpen(
  [in]      IN PV_NET_ROOT VNetRoot,
  [in, out] IN OUT PFCB    Fcb
);

Paramètres

[in] VNetRoot

Pointeur vers la structure V_NET_ROOT.

[in, out] Fcb

Pointeur vers la structure FCB associée.

Valeur retournée

RxCreateSrvOpen retourne un pointeur vers une structure de données SRV_OPEN nouvellement créée en cas de réussite ou un pointeur NULL en cas d’échec.

Remarques

La routine RxCreateSrvOpen n’est normalement pas appelée directement par les pilotes de mini-redirecteur réseau. RDBSS appelle cette routine en interne lorsqu’un paquet de demande d’E/S est reçu pour IRP_MJ_CREATE et qu’un SRV_OPEN doit être créé. Cette IRP est normalement reçue par RDBSS en réponse à une application en mode utilisateur demandant une opération de création de fichier sur un partage réseau. Il est également possible pour un autre pilote de noyau d’émettre un tel IRP.

Avant d’appeler RxCreateSrvOpen, un verrou sur la structure FCB associée doit être acquis en mode exclusif.

RxCreateSrvOpen essaiera d’utiliser les SRV_CALL allouées dans le cadre de la structure FCB associée, si elle est disponible. Si le SRV_CALL alloué avec le fcb n’est pas disponible, RxCreateSrvOpen alloue une nouvelle structure SRV_CALL.

Si le fcB associé est un fichier de pagination, RxCreateSrvOpen alloue de la mémoire de pool non paginée lors de la création de la nouvelle structure de données SRV_OPEN. Si le fcb associé n’est pas un fichier de pagination, RxCreateSrvOpen alloue de la mémoire du pool paginé lors de la création de la structure de données SRV_OPEN.

Actuellement, Windows n’autorise pas la création d’un fichier de pagination sur un ordinateur distant.