Funzione RtlFindClearRuns (wdm.h)
La routine RtlFindClearRuns trova il numero specificato di esecuzioni di bit chiari all'interno di una determinata bitmap.
Sintassi
NTSYSAPI ULONG RtlFindClearRuns(
[in] PRTL_BITMAP BitMapHeader,
[out] PRTL_BITMAP_RUN RunArray,
[in] ULONG SizeOfRunArray,
[in] BOOLEAN LocateLongestRuns
);
Parametri
[in] BitMapHeader
Puntatore alla struttura RTL_BITMAP che descrive la bitmap. Questa struttura deve essere stata inizializzata dalla routine RtlInitializeBitMap .
[out] RunArray
Puntatore al primo elemento in una matrice allocata dal chiamante per la posizione e la lunghezza di ogni esecuzione non crittografata trovata nella variabile bitmap specificata.
[in] SizeOfRunArray
Specifica il numero massimo di esecuzioni cancellate per soddisfare questa richiesta.
[in] LocateLongestRuns
Se TRUE, specifica che la routine consiste nel cercare nell'intera bitmap le esecuzioni di cancellazione più lunghe che è possibile trovare. In caso contrario, la routine interrompe la ricerca quando ha trovato il numero di esecuzioni cancellate specificate da SizeOfRunArray.
Valore restituito
RtlFindClearRuns restituisce il numero di esecuzioni non crittografate trovate.
Commenti
Se LocateLongestRuns è TRUE, le esecuzioni cancellate indicate in RunArray vengono ordinate dal più lungo al più breve. Un'esecuzione chiara può essere costituita da un singolo bit.
I chiamanti di RtlFindClearRuns devono essere in esecuzione in IRQL <= APC_LEVEL se la memoria che contiene la variabile bitmap è paging o la memoria in BitMapHeader è paginabile. In caso contrario, RtlFindClearRuns 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) |