Fonction RtlFindLastBackwardRunClear (wdm.h)

Article
03/01/2024

La routine RtlFindLastBackwardRunClear recherche dans une bitmap donnée la série de bits effacée précédente, à partir de la position d’index spécifiée.

Syntaxe

NTSYSAPI ULONG RtlFindLastBackwardRunClear(
  [in]  PRTL_BITMAP BitMapHeader,
  [in]  ULONG       FromIndex,
  [out] PULONG      StartingRunIndex
);

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 .

[in] FromIndex

Spécifie une position de bits de base zéro à partir de laquelle commencer à rechercher une série claire de bits.

[out] StartingRunIndex

Pointeur vers une variable dans laquelle l’index de départ de l’exécution en clair trouvé dans la bitmap est retourné. Il s’agit d’une valeur de base zéro indiquant la position du bit du premier bit clair de l’exécution précédant le FromIndex donné. Sa valeur n’a aucun sens si RtlFindLastBackwardRunClear ne peut pas trouver une série de bits clairs.

Valeur retournée

RtlFindLastBackwardRunClear retourne le nombre de bits dans l’exécution à partir de StartingRunIndex, ou zéro s’il ne trouve pas une exécution de bits clairs précédant FromIndex dans la bitmap.

Remarques

Les appelants de RtlFindLastBackwardRunClear doivent être en cours d’exécution sur IRQL <= APC_LEVEL si la mémoire qui contient la variable bitmap est paginable ou la mémoire dans BitMapHeader est paginable. Sinon, RtlFindLastBackwardRunClear 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)