READ_REGISTER_BUFFER_ULONG, fonction (wdm.h)

Le READ_REGISTER_BUFFER_ULONG routine déréférence le pointeur fourni, insère une barrière mémoire et lit un ensemble de valeurs ULONG de l’adresse de registre spécifiée dans une mémoire tampon.

Syntaxe

void READ_REGISTER_BUFFER_ULONG(
  [in]  volatile ULONG *Register,
  [out] PULONG         Buffer,
  [in]  ULONG          Count
);

Paramètres

[in] Register

Pointeur vers le registre, qui doit être une plage mappée dans l’espace mémoire.

[out] Buffer

Pointeur vers une mémoire tampon dans laquelle un tableau de valeurs ULONG est lu.

[in] Count

Spécifie le nombre de valeurs ULONG à lire dans la mémoire tampon.

Valeur de retour

None

Remarques

Cette routine insère une barrière de mémoire dans votre code. Cette barrière garantit que chaque opération qui apparaît dans le code source avant l’appel à cette routine se termine avant toute opération qui apparaît après l’appel.

Pour plus d’informations sur les barrières de mémoire, consultez KeMemoryBarrier.

La taille de la mémoire tampon doit être suffisamment grande pour contenir au moins le nombre spécifié de valeurs ULONG.

Les appelants de READ_REGISTER_BUFFER_ULONG peuvent être en cours d’exécution sur n’importe quel IRQL, en supposant que la mémoire tampon est résidente et que le registre est résident, la mémoire de l’appareil mappée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	N’importe quel niveau (voir la section Remarques)