READ_REGISTER_BUFFER_UCHAR, fonction (wdm.h)

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