Funzione RtlClearBits (wdm.h)
La routine RtlClearBits imposta tutti i bit nell'intervallo specificato di bit nella bitmap su zero.
Sintassi
NTSYSAPI VOID RtlClearBits(
[in] PRTL_BITMAP BitMapHeader,
[in] ULONG StartingIndex,
[in] ULONG NumberToClear
);
Parametri
[in] BitMapHeader
Puntatore alla struttura RTL_BITMAP che descrive la bitmap. Questa struttura deve essere stata inizializzata dalla routine RtlInitializeBitMap .
[in] StartingIndex
Indice del primo bit nell'intervallo di bit da cancellare. Se la bitmap contiene N bit, i bit vengono numerati da 0 a N-1.
[in] NumberToClear
Specifica il numero di bit da cancellare. Se la bitmap contiene N bit, questo parametro può essere un valore nell'intervallo da 1 a (N - StartingIndex).
Valore restituito
Questa routine non restituisce un valore.
Commenti
Se il parametro NumberToClear è zero, RtlClearBits restituisce semplicemente il controllo senza cancellare alcun bit.
La somma (StartingIndex + NumberToClear) non deve superare il valore del parametro SizeOfBitMap specificato nella chiamata RtlInitializeBitMap che inizializza la bitmap.
I chiamanti di RtlClearBits devono essere in esecuzione in IRQL <= APC_LEVEL se la memoria contenente la bitmap è paginabile o la memoria in BitMapHeader è paginabile. In caso contrario, RtlClearBits 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 sezione Osservazioni). |