GpioController.OpenPin Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.