Funzione RtlSetBits (wdm.h)

Articolo
02/27/2024

La routine RtlSetBits imposta tutti i bit in un determinato intervallo di una determinata variabile bitmap.

Sintassi

NTSYSAPI VOID RtlSetBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       NumberToSet
);

Parametri

[in] BitMapHeader

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

[in] StartingIndex

Specifica l'inizio dell'intervallo di bit da impostare. Si tratta di un valore in base zero che indica la posizione del primo bit nell'intervallo.

[in] NumberToSet

Specifica il numero di bit da impostare.

Valore restituito

nessuno

Osservazioni

RtlSetBits restituisce semplicemente il controllo se l'input NumberToSet è zero. StartingIndex più NumberToSet deve essere minore o uguale a BitMapHeader-SizeOfBitMap>.

I chiamanti di RtlSetBits 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, RtlSetBits 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 (modalità kernel); Ntdll.dll (modalità utente)
IRQL	<= APC_LEVEL (vedere la sezione Osservazioni)