Compartilhar via

Função PwmParsePinPath (pwmutil.h)

  • Artigo

Analisa um caminho de pino no namespace do controlador PWM (Pulse Width Modulation) para validar seu formato e extrair o número do pino.

Sintaxe

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

Parâmetros

[in] PinPath

Um ponteiro para fixar o caminho como uma cadeia de caracteres Unicode.

[out, optional] PinNumber

Um ponteiro para a variável que recebe um número de pino.

Valor de retorno

PwmParsePinPath retorna os seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS
 Caminho de pino extraído com êxito do caminho de pino fornecido.
STATUS_INVALID_PARAMETER
 O ponteiro de caminho de pino especificado é inválido ou sua cadeia de caracteres Unicode é inválida.
STATUS_NO_SUCH_FILE
 O caminho do pino especificado não constitui um caminho de pino válido.

Observações

O caminho do pino deve ser uma cadeia de caracteres Unicode que termina no número do pino da seguinte maneira: ...<>PinNumber.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 10, versão 1709
servidor com suporte mínimo Windows Server 2016
da Plataforma de Destino Windows
versão mínima do KMDF 1.19
versão mínima do UMDF 2.19
cabeçalho pwmutil.h (inclua Pwm.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe (modo kernel)