Partager via

DUMP_WRITE fonction de rappel (ntdddump.h)

  • Article

La routine de rappel Dump_Write est appelée avant l’écriture dans le pilote de port de vidage. Le pilote de filtre peut accéder aux données de vidage pour le moment.

Syntaxe

DUMP_WRITE DumpWrite;

NTSTATUS DumpWrite(
  [in]      PFILTER_EXTENSION FilterExtension,
  [in, out] PLARGE_INTEGER DiskByteOffset,
  [in, out] PMDL Mdl
)
{...}

Paramètres

[in] FilterExtension

Pointeur vers une structure FILTER_EXTENSION .

[in, out] DiskByteOffset

Valeur, en octets, par rapport à la partition de destination pour le vidage sur incident ou la mise en veille prolongée. Les pilotes de filtre ne doivent pas modifier ce champ.

[in, out] Mdl

Pointeur vers une structure MDL qui décrit la mémoire tampon de données. Si le MDL est modifié, la taille de l’opération d’écriture ne peut pas changer.

Valeur retournée

Si la routine réussit, elle doit retourner STATUS_SUCCESS. Sinon, il doit retourner l’une des valeurs d’erreur status définies dans Ntstatus.h.

Remarques

Les pilotes de filtre peuvent lire les données qui doivent être écrites. Toutefois, les pilotes de filtre ne peuvent pas écrire dans la mémoire tampon, car cela pourrait modifier le contenu du code ou des données utilisés par le processus de vidage sur incident. En outre, les pilotes de filtre ne sont pas autorisés à modifier la taille des données.

Pour modifier en toute sécurité les données pour l’écriture de vidage, un pilote de filtre doit allouer une mémoire tampon secondaire. La taille de la mémoire tampon sera la valeur du membre MaxPagesPerWrite de FILTER_INITIALIZATION_DATA multipliée par PAGE_SIZE. Les données de la mémoire tampon actuelle décrite par Mdl sont copiées dans la mémoire tampon secondaire et traitées. Une fois que le filtre a terminé de gérer les données de vidage dans la mémoire tampon secondaire, le MDL pointé par Mdl est mis à jour avec l’adresse de la mémoire tampon secondaire. L’adresse de départ du jeu de mémoires tampons secondaires dans le MDL doit être alignée sur la page.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows Vista et Windows Server 2008.
Plateforme cible Desktop (Expérience utilisateur)
En-tête ntdddump.h (inclure Ntdddump.h)

Voir aussi

Dump_Read

FILTER_EXTENSION

FILTER_INITIALIZATION_DATA