PwmParsePinPath, fonction (pwmutil.h)

Article
02/07/2025

Analyse un chemin d’accès d’épingle sous l’espace de noms du contrôleur PWM (Pulse Width Modulation) pour valider son format et extraire le numéro de broche.

Syntaxe

NTSTATUS PwmParsePinPath(
  [in]            UNICODE_STRING *PinPath,
  [out, optional] ULONG          *PinNumber
);

Paramètres

[in] PinPath

Pointeur pour épingler le chemin sous la forme d’une chaîne de caractères Unicode.

[out, optional] PinNumber

Pointeur vers une variable qui reçoit un numéro d’épingle.

Valeur de retour

PwmParsePinPath retourne les valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	Chemin d’accès de broche extrait avec succès à partir du chemin d’accès de broche fourni.
STATUS_INVALID_PARAMETER	Le pointeur de chemin d’accès d’épingle spécifié n’est pas valide ou sa chaîne Unicode n’est pas valide.
STATUS_NO_SUCH_FILE	Le chemin d’accès de broche spécifié ne constitue pas un chemin d’accès de broche valide.

Remarques

Le chemin d’accès de l’épingle doit être une chaîne de caractères Unicode qui se termine par le numéro d’épingle comme suit : ...<PinNumber>.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1709
serveur minimum pris en charge	Windows Server 2016
plateforme cible	Windows
version minimale de KMDF	1.19
version minimale de UMDF	2.19
d’en-tête	pwmutil.h (include Pwm.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau)

Partager via