PwmParsePinPath, fonction (pwmutil.h)

  • Article

Analyse un chemin d’accès de broche 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 forme de chaîne de caractères Unicode.

[out, optional] PinNumber

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

Valeur retournée

PwmParsePinPath retourne les valeurs suivantes :

Code de retour Description
STATUS_SUCCESS
 Chemin d’accès de broche correctement extrait à 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 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>.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1709
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Windows
Version KMDF minimale 1,19
Version UMDF minimale 2.19
En-tête pwmutil.h (inclure Pwm.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe (mode noyau)