Funzione RtlClearBits (wdm.h)

Articolo
08/08/2023

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).