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 StringLengthFromMode function calculates the length of a null-terminated string, based on the specified processor mode.
Syntax
SIZE_T StringLengthFromMode(
const CHAR *String,
KPROCESSOR_MODE Mode
);
Parameters
String
[in] Pointeur vers une chaîne terminée par null.
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 | String points to kernel-mode memory. La fonction effectue un calcul de longueur de chaîne directe. Pour plus d’informations, consultez les remarques. |
| UserMode | String points to user-mode memory. The function raises an exception if String doesn't point to user-mode memory; otherwise it performs a safe string length calculation at the specified address. Pour plus d’informations, consultez les remarques. |
Return value
La fonction retourne la longueur de la chaîne en caractères, sans inclure le caractère null de fin.
Remarks
Cette fonction fournit un accès sécurisé pour calculer la longueur d’une chaîne terminée par null en mémoire. Le comportement dépend du mode processeur spécifié :
- When Mode is UserMode, the function ensures that the string 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.
When the mode is UserMode, the function includes validation to prevent kernel crashes when accessing potentially invalid user-mode pointers. When the mode is KernelMode, it operates on known-safe kernel addresses for optimal performance.
La fonction déclenche une exception structurée si l’opération échoue, par exemple lorsque l’adresse de chaîne 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 |