Fonction RtlFindClearRuns (wdm.h)

Article
03/01/2024

La routine RtlFindClearRuns recherche le nombre spécifié d’exécutions de bits clairs dans une bitmap donnée.

Syntaxe

NTSYSAPI ULONG RtlFindClearRuns(
  [in]  PRTL_BITMAP     BitMapHeader,
  [out] PRTL_BITMAP_RUN RunArray,
  [in]  ULONG           SizeOfRunArray,
  [in]  BOOLEAN         LocateLongestRuns
);

Paramètres

[in] BitMapHeader

Pointeur vers la structure RTL_BITMAP qui décrit la bitmap. Cette structure doit avoir été initialisée par la routine RtlInitializeBitMap .

[out] RunArray

Pointeur vers le premier élément d’un tableau alloué par l’appelant pour la position de bits et la longueur de chaque exécution en clair trouvée dans la variable bitmap donnée.

[in] SizeOfRunArray

Spécifie le nombre maximal d’exécutions en clair pour répondre à cette demande.

[in] LocateLongestRuns

Si la valeur est TRUE, spécifie que la routine consiste à rechercher dans la bitmap entière les exécutions en clair les plus longues qu’elle peut trouver. Sinon, la routine cesse de rechercher lorsqu’elle a trouvé le nombre d’exécutions en clair spécifié par SizeOfRunArray.

Valeur retournée

RtlFindClearRuns retourne le nombre d’exécutions en clair trouvées.

Remarques

Si LocateLongestRuns a la valeur TRUE, les exécutions en clair indiquées dans RunArray sont triées du plus long au plus court. Une exécution en clair peut être constituée d’un seul bit.

Les appelants de RtlFindClearRuns doivent être en cours d’exécution sur IRQL <= APC_LEVEL si la mémoire qui contient la variable bitmap est paginable ou si la mémoire de BitMapHeader est paginable. Sinon, RtlFindClearRuns peut être appelé au niveau de n’importe quel IRQL.

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
IRQL	<= APC_LEVEL (voir la section Notes)