FltGetNewSystemBufferAddress, fonction (fltkernel.h)
La fonction FltGetNewSystemBufferAddress récupère la mémoire tampon AssociatedIrp.SystemBuffer, que le système de fichiers a allouée. Une routine post-rappel d’un pilote minifilter appelle cette fonction.
Syntaxe
PVOID FLTAPI FltGetNewSystemBufferAddress(
[in] PFLT_CALLBACK_DATA CallbackData
);
Paramètres
[in] CallbackData
Pointeur vers une structure FLT_CALLBACK_DATA qui représente une opération d’E/S.
Valeur de retour
Si la mémoire tampon AssociatedIrp.SystemBuffer a été allouée par le système de fichiers, FltGetNewSystemBufferAddress retourne un pointeur vers cette mémoire tampon ; sinon, elle retourne NULL .
Remarques
Une routine post-rappel d’un pilote minifilter appelle Fonction FltGetNewSystemBufferAddress pour récupérer un pointeur vers la mémoire tampon AssociatedIrp.SystemBuffer allouée par le système de fichiers. Un pilote minifilter doit appeler cette fonction uniquement lorsque l’indicateur de FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER est défini dans CallbackData.Flags.
Lorsque le système de fichiers alloue sa propre mémoire tampon AssociatedIrp.SystemBuffer, filter Manager définit l’indicateur FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER. Cela signale au minifiltre que la mémoire tampon qu’ils ont reçue dans la pré-opération n’est pas celle qui contient les données lues à partir du système de fichiers.
Si l’indicateur FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER n’est pas défini, cette routine retourne NULL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Microsoft Windows 7 et versions ultérieures du système d’exploitation Windows. |
| plateforme cible | Universel |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| bibliothèque | Fltmgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= DISPATCH_LEVEL |