PwmParsePinPath-Funktion (pwmutil.h)

  • Artikel

Analysiert einen Pinpfad unter dem PWM-Controllernamespace (Pulse Width Modulation), um dessen Format zu überprüfen und die Pinnummer zu extrahieren.

Syntax

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

Parameter

[in] PinPath

Ein Zeiger zum Anheften des Pfads als Unicode-Zeichenfolge.

[out, optional] PinNumber

Ein Zeiger auf eine Variable, die eine Pinnummer empfängt.

Rückgabewert

PwmParsePinPath gibt die folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
 Der Pinpfad wurde erfolgreich aus dem angegebenen Pinpfad extrahiert.
STATUS_INVALID_PARAMETER
 Der angegebene Pinpfadzeiger ist ungültig oder seine Unicode-Zeichenfolge ungültig.
STATUS_NO_SUCH_FILE
 Der angegebene Pinpfad stellt keinen gültigen Pinpfad dar.

Hinweise

Der Pinpfad muss eine Unicode-Zeichenfolge sein, die in der Pinnummer wie folgt endet: ...<PinNumber>.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1709
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
KMDF-Mindestversion 1.19
UMDF-Mindestversion 2.19
Kopfzeile pwmutil.h (einschließlich Pwm.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe (Kernelmodus)