Funzione RtlFindNextForwardRunClear (wdm.h)

Articolo
02/29/2024

La routine RtlFindNextForwardRunClear cerca una determinata variabile bitmap per l'esecuzione di bit non crittografata successiva, a partire dalla posizione di indice specificata.

Sintassi

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

Parametri

[in] BitMapHeader

Puntatore alla struttura RTL_BITMAP che descrive la bitmap. Questa struttura deve essere stata inizializzata dalla routine RtlInitializeBitMap .

[in] FromIndex

Specifica una posizione di bit in base zero in corrispondenza della quale iniziare a cercare una chiara esecuzione di bit.

[out] StartingRunIndex

Puntatore a una variabile in cui viene restituito l'indice iniziale dell'esecuzione non crittografata trovata nella bitmap. Si tratta di un valore in base zero che indica la posizione di bit del primo bit chiaro nell'esecuzione. Il valore è senza significato se RtlFindNextForwardRunClear non riesce a trovare un'esecuzione di bit chiari.

Valore restituito

RtlFindNextForwardRunClear restituisce il numero di bit nell'esecuzione a partire da StartingRunIndex oppure zero se non riesce a trovare un'esecuzione di bit chiari che seguono FromIndex nella bitmap.

Commenti

I chiamanti di RtlFindNextForwardRunClear devono essere in esecuzione in IRQL <= APC_LEVEL se la memoria che contiene la variabile bitmap è paginabile o la memoria in BitMapHeader è paginabile. In caso contrario, RtlFindNextForwardRunClear può essere chiamato in qualsiasi IRQL.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL (vedere la sezione Osservazioni)