Fonction RtlInitializeBitMap (wdm.h)

Article
02/29/2024

La routine RtlInitializeBitMap initialise l’en-tête d’une variable bitmap.

Syntaxe

NTSYSAPI VOID RtlInitializeBitMap(
  [out] PRTL_BITMAP             BitMapHeader,
  [in]  __drv_aliasesMem PULONG BitMapBuffer,
  [in]  ULONG                   SizeOfBitMap
);

Paramètres

[out] BitMapHeader

Pointeur vers une structure RTL_BITMAP vide.

[in] BitMapBuffer

Pointeur vers la mémoire allouée à l’appelant pour la bitmap elle-même. L’adresse de base de cette mémoire tampon doit être alignée sur ULONG. La taille de la mémoire tampon allouée doit être un multiple entier d’octets sizeof (ULONG).

[in] SizeOfBitMap

Spécifie le nombre de bits dans la bitmap. Cette valeur peut être n’importe quel nombre de bits qui tiennent dans la mémoire tampon allouée pour la bitmap.

Valeur de retour

None

Remarques

Un pilote peut utiliser une variable bitmap comme moyen économique de suivre un ensemble d’éléments réutilisables. Par exemple, les systèmes de fichiers utilisent une variable bitmap pour suivre les clusters/secteurs sur un disque qui ont déjà été alloués pour stocker des données de fichier. Le pilote de port SCSI fourni par le système utilise une variable bitmap pour suivre les balises de file d’attente qui ont été affectées à des blocs de requête SCSI (SBS).

RtlInitializeBitMap doit être appelé avant toute autre routine RtlXxx qui fonctionne sur une variable bitmap. Le pointeur BitMapHeader est un paramètre d’entrée dans tous les appels RtlXxx suivants qui opèrent sur la variable bitmap de l’appelant sur BitMapBuffer. L’appelant est responsable de la synchronisation de l’accès à la variable bitmap.

RtlInitializeBitMap initialise la structure de RTL_BITMAP fournie par l’appelant en copiant les valeurs BitMapBuffer et SizeOfBitMap fournies par l’appelant. Par la suite, la structure peut être passée à d’autres routines pour manipuler la bitmap. RtlInitializeBitMap ne modifie pas le contenu de la bitmap.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur)
IRQL	N’importe quel IRQL si BitMapHeader est résident en mémoire ; <= APC_LEVEL si BitMapHeader est paginable ou sur Windows 7 et versions antérieures