Funzione RtlFindFirstRunClear (wdm.h)
La routine RtlFindFirstRunClear cerca l'intervallo contiguo iniziale di bit chiari all'interno di una determinata bitmap.
Sintassi
NTSYSAPI ULONG RtlFindFirstRunClear(
[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 della cancellazione iniziale nella bitmap. Si tratta di un valore in base zero che indica la posizione di bit del primo bit chiaro nell'intervallo restituito. Il valore è senza significato se RtlFindFirstRunClear non riesce a trovare un'esecuzione di bit chiari.
Valore restituito
RtlFindFirstRunClear 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. Ovvero, una volta trovato un bit chiaro, RtlFindFirstRunClear continua la ricerca fino a trovare il bit del set successivo e quindi restituisce il numero di bit chiari nell'esecuzione trovata.
I chiamanti di RtlFindFirstRunClear 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, RtlFindFirstRunClear 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) |