READ_REGISTER_BUFFER_UCHAR, fonction (wdm.h)

  • Article

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

Syntaxe

void READ_REGISTER_BUFFER_UCHAR(
  [in]  volatile UCHAR *Register,
  [out] PUCHAR         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 UCHAR est lu.

[in] Count

Spécifie le nombre d’octets à 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 d’octets spécifié.

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

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)