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

Vedi anche

RTL_BITMAP

RtlAreBitsClear

RtlFindClearBits

RtlFindFirstRunClear

RtlFindLastBackwardRunClear

RtlFindLongestRunClear

RtlFindNextForwardRunClear

RtlInitializeBitMap