PwmParsePinPath 函数 (pwmutil.h)

分析脉冲宽度调制 (PWM) 控制器命名空间下的引脚路径，以验证其格式并提取引脚编号。

语法

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

[in] PinPath

指向作为 Unicode 字符串的固定路径的指针。

[out, optional] PinNumber

指向接收引脚编号的变量的指针。

PwmParsePinPath 返回以下值：

返回代码	说明
STATUS_SUCCESS	已成功从提供的引脚路径中提取引脚路径。
STATUS_INVALID_PARAMETER	指定的 pin 路径指针无效或其 Unicode 字符串无效。
STATUS_NO_SUCH_FILE	指定的引脚路径不构成有效的引脚路径。

引脚路径必须是以引脚编号结尾的 Unicode 字符串，如下所示： ...<PinNumber>。