Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
The InterlockedOrToMode function performs an atomic OR operation on a 32-bit value, based on the specified processor mode.
Syntax
LONG InterlockedOrToMode(
LONG volatile *Destination,
LONG Value,
KPROCESSOR_MODE Mode
);
Parameters
Destination
[in, out] Pointeur vers l’emplacement de mémoire contenant le premier opérande. Cette valeur sera remplacée par le résultat de l’opération. The pointer must be naturally aligned for the data type; that is, the memory location must be 4-byte aligned since Destination points to a 4-byte type.
Value
[in] Deuxième opérande.
Mode
[in] Mode processeur qui détermine la façon dont l’accès à la mémoire est effectué. Mode can be one of the following values.
| Value | Meaning |
|---|---|
| KernelMode | Destination points to kernel-mode memory. La fonction effectue une opération OR atomique directe. Pour plus d’informations, consultez les remarques. |
| UserMode | Destination points to user-mode memory. The function raises an exception if Destination doesn't point to user-mode memory; otherwise it performs an atomic OR operation at the specified address. Pour plus d’informations, consultez les remarques. |
Return value
The function returns the original value of the Destination parameter.
Remarks
Les fonctions interblocées fournissent un mécanisme simple pour synchroniser l’accès à une variable partagée par plusieurs threads. Cette fonction est atomique par rapport aux appels à d’autres fonctions interblocées. Il génère une barrière de mémoire complète pour s’assurer que les opérations de mémoire sont terminées dans l’ordre.
This function provides atomic access to a 32-bit value in memory, performing a bitwise OR operation between the value at Destination and Value. Le comportement dépend du mode processeur spécifié :
- When Mode is UserMode, the function ensures that the destination address is a valid user-mode address and performs the operation safely for user-mode memory access.
- When Mode is KernelMode, the function operates directly on kernel-mode addresses.
La fonction déclenche une exception structurée si l’opération échoue, par exemple lorsque l’adresse de destination n’est pas accessible ou n’est pas valide pour le mode spécifié.
Cette fonction fonctionne sur toutes les versions de Windows, pas seulement sur la dernière version. You need to consume the latest WDK to get the function declaration from the usermode_accessors.h header. You also need the library (umaccess.lib) from the latest WDK. Toutefois, le pilote résultant s’exécutera correctement sur les versions antérieures de Windows.
Requirements
| Requirement | Value |
|---|---|
| Client minimum requis | See Remarks |
| Header | usermode_accessors.h |
| Library | umaccess.lib |
| IRQL | Inférieur ou égal à APC_LEVEL |