Share via


GpioController.OpenPin Método

Definição

Sobrecargas

OpenPin(Int32)

Abre uma conexão com o pino de E/S de uso geral (GPIO) especificado no modo exclusivo.

OpenPin(Int32, GpioSharingMode)

Abre o pino de E/S de uso geral (GPIO) especificado no modo especificado.

OpenPin(Int32)

Abre uma conexão com o pino de E/S de uso geral (GPIO) especificado no modo exclusivo.

public:
 virtual GpioPin ^ OpenPin(int pinNumber) = OpenPin;
/// [Windows.Foundation.Metadata.Overload("OpenPin")]
GpioPin OpenPin(int const& pinNumber);
[Windows.Foundation.Metadata.Overload("OpenPin")]
public GpioPin OpenPin(int pinNumber);
function openPin(pinNumber)
Public Function OpenPin (pinNumber As Integer) As GpioPin

Parâmetros

pinNumber
Int32

int

O número do pino do GPIO que você deseja abrir. O número do pino deve ser

  • no intervalo
  • disponível para aplicativos de modelo de usuário

Os números de pino começam em 0 e aumentam para o número máximo de pinos, que é um a menos do que o valor retornado por GpioController.PinCount.

Quais pinos estão disponíveis para o modo de usuário depende da placa de circuito na qual o código está em execução. Para obter informações sobre como os números de pino correspondem aos pinos físicos, consulte a documentação do quadro de circuitos. Mapeamentos de pino para placas como o Raspberry Pi estão disponíveis no Centro de desenvolvedores de IoT.

Retornos

O pino GPIO aberto.

Atributos

Comentários

Códigos de erro:

E_INVALIDARG (0x80070057)

Um parâmetro inválido foi especificado. Esse erro será retornado se o número do pino estiver fora do intervalo. Os números de pino começam em 0 e aumentam para o número máximo de pinos, que é um a menos do que o valor retornado por GpioController.PinCount.

HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)

O pino não está disponível para aplicativos usermode; ele é reservado pelo sistema. Consulte a documentação da placa de circuito para descobrir quais pinos estão disponíveis para aplicativos de modelo de usuário.

HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)

No momento, o pino está aberto em um modo de compartilhamento incompatível. Por exemplo:

  • O pino já está aberto no modo GpioSharingMode.Exclusive .
  • O pino já está aberto no modo GpioSharingMode.SharedReadOnly quando você solicita abri-lo no modo GpioSharingMode.Exclusive .

HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)

No momento, o pino está muxado para uma função diferente; por exemplo, I2C, SPI ou UART. Verifique se o pino não está em uso por outra função.

HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)

O driver GPIO retornou um erro. Verifique se o driver GPIO está em execução e configurado corretamente.

Confira também

Aplica-se a

OpenPin(Int32, GpioSharingMode)

Abre o pino de E/S de uso geral (GPIO) especificado no modo especificado.

public:
 virtual GpioPin ^ OpenPin(int pinNumber, GpioSharingMode sharingMode) = OpenPin;
/// [Windows.Foundation.Metadata.Overload("OpenPinWithSharingMode")]
GpioPin OpenPin(int const& pinNumber, GpioSharingMode const& sharingMode);
[Windows.Foundation.Metadata.Overload("OpenPinWithSharingMode")]
public GpioPin OpenPin(int pinNumber, GpioSharingMode sharingMode);
function openPin(pinNumber, sharingMode)
Public Function OpenPin (pinNumber As Integer, sharingMode As GpioSharingMode) As GpioPin

Parâmetros

pinNumber
Int32

int

O número do pino do GPIO que você deseja abrir. O número do pino deve ser

  • no intervalo
  • disponível para aplicativos de modelo de usuário

Os números de pino começam em 0 e aumentam para o número máximo de pinos, que é um a menos do que o valor retornado por GpioController.PinCount.

Quais pinos estão disponíveis para o modo de usuário depende da placa de circuito na qual o código está em execução. Para obter informações sobre como os números de pino correspondem aos pinos físicos, consulte a documentação do quadro de circuitos. Mapeamentos de pino para placas como o Raspberry Pi estão disponíveis no Centro de desenvolvedores de IoT.

sharingMode
GpioSharingMode

O modo no qual você deseja abrir o pino GPIO, que determina se outras conexões com o pino podem ser abertas enquanto você tem o pino aberto.

Retornos

O pino GPIO aberto.

Atributos

Comentários

Códigos de erro:

E_INVALIDARG (0x80070057)

Um parâmetro inválido foi especificado. Esse erro será retornado se o número do pino estiver fora do intervalo. Os números de pino começam em 0 e aumentam para o número máximo de pinos, que é um a menos do que o valor retornado por GpioController.PinCount.

HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)

O pino não está disponível para aplicativos usermode; ele é reservado pelo sistema. Consulte a documentação da placa de circuito para descobrir quais pinos estão disponíveis para aplicativos de modelo de usuário.

HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)

No momento, o pino está aberto em um modo de compartilhamento incompatível. Por exemplo:

  • O pino já está aberto no modo GpioSharingMode.Exclusive .
  • O pino já está aberto no modo GpioSharingMode.SharedReadOnly quando você solicita abri-lo no modo GpioSharingMode.Exclusive .

HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)

No momento, o pino está muxado para uma função diferente; por exemplo, I2C, SPI ou UART. Verifique se o pino não está em uso por outra função.

HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)

O driver GPIO retornou um erro. Verifique se o driver GPIO está em execução e configurado corretamente.

Confira também

Aplica-se a