Routine MRxCollapseOpen

Article
06/14/2023

La routine MRxCollapseOpen est appelée par RDBSS pour demander que le mini-redirecteur réseau réduise une requête de système de fichiers ouvert sur une structure de SRV_OPEN existante.

Syntaxe

PMRX_CALLDOWN MRxCollapseOpen;

NTSTATUS MRxCollapseOpen(
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

Paramètres

RxContext [in, out]
Pointeur vers la structure RX_CONTEXT. Ce paramètre contient l’IRP qui demande l’opération.

Valeur retournée

MRxCollapseOpen retourne STATUS_SUCCESS sur la réussite ou une valeur NTSTATUS appropriée, telle que :

Code de retour	Description
STATUS_INSUFFICIENT_RESOURCES	Les ressources étaient insuffisantes pour terminer l’opération.

Remarques

MRxCollapseOpen est appelé par RDBSS pour réduire une structure SRV_OPEN localement. Le mini-redirecteur réseau est consulté pour déterminer si un effondrement est possible, de sorte qu’il n’y a aucune raison d’appeler le mini-redirecteur réseau deux fois. Si le mini-redirecteur réseau décide de réduire la structure SRV_OPEN, il le fait et transmet une status retournable. Une valeur de retour de STATUS_SUCCESS est une valeur de retour de fin. Une autre valeur de retour, par exemple, STATUS_MORE_PROCESSING_REQUIRED, est considérée comme une valeur de retour qui ne se termine pas.

Avant d’appeler MRxCollapseOpen, RDBSS modifie les membres suivants dans la structure RX_CONTEXT pointée vers le paramètre RxContext :

pRelevantSrvOpen est défini sur la structure SRV_OPEN à réduire.

Create.pSrvCall est défini sur la structure SRV_CALL associée au SRV_OPEN.

Si le mini-redirecteur réseau décide de réduire la structure SRV_OPEN, le membre SrvOpen de la structure RX_CONTEXT doit être défini sur la structure SRV_OPEN réduite.