Función PwmParsePinPath (pwmutil.h)

Analiza una ruta de acceso de patilla en el espacio de nombres del controlador de modulación de ancho de pulso (PWM) para validar su formato y extraer el número de patilla.

Sintaxis

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

Parámetros

[in] PinPath

Puntero para anclar la ruta de acceso como una cadena de caracteres Unicode.

[out, optional] PinNumber

Puntero a variable que recibe un número de patilla.

Valor devuelto

pwmParsePinPath devuelve los siguientes valores:

Código devuelto	Descripción
STATUS_SUCCESS	Se extrajo correctamente la ruta de acceso de anclaje de la ruta de acceso de anclaje proporcionada.
STATUS_INVALID_PARAMETER	El puntero de ruta de acceso de anclaje especificado no es válido o su cadena Unicode no es válida.
STATUS_NO_SUCH_FILE	La ruta de acceso de anclaje especificada no constituye una ruta de acceso de patilla válida.

Observaciones

La ruta de acceso de anclaje debe ser una cadena de caracteres Unicode que termina en el número de patilla como se indica a continuación: ...<PinNumber>.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10, versión 1709
servidor mínimo admitido	Windows Server 2016
de la plataforma de destino de	Windows
versión mínima de KMDF	1.19
versión mínima de UMDF	2.19
encabezado de	pwmutil.h (include Pwm.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe (modo kernel)