Partager via


PwmParsePinPath, fonction (pwmutil.h)

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)