Condividi tramite


Funzione RtlFindLongestRunClear (wdm.h)

La routine RtlFindLongestRunClear cerca l'intervallo contiguo più grande di bit chiari all'interno di una determinata bitmap.

Sintassi

NTSYSAPI ULONG RtlFindLongestRunClear(
  [in]  PRTL_BITMAP BitMapHeader,
  [out] PULONG      StartingIndex
);

Parametri

[in] BitMapHeader

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

[out] StartingIndex

Puntatore a una variabile in cui viene restituito l'indice iniziale dell'esecuzione chiara più lunga nella bitmap. Si tratta di un valore in base zero che indica la posizione di bit del primo bit chiaro nell'intervallo restituito.

Valore restituito

RtlFindLongestRunClear restituisce il numero di bit nell'esecuzione a partire da StartingIndex oppure zero se non riesce a trovare un'esecuzione di bit chiari all'interno della bitmap.

Commenti

Un'esecuzione restituita può avere un singolo bit chiaro.

I chiamanti di RtlFindLongestRunClear 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, RtlFindLongestRunClear 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)

Vedi anche

RTL_BITMAP

RtlAreBitsClear

RtlFindClearBits

RtlFindClearRuns

RtlFindFirstRunClear

RtlFindLastBackwardRunClear

RtlFindLongestRunClear

RtlFindNextForwardRunClear

RtlInitializeBitMap

RtlNumberOfClearBits

RtlSetBits