GpioController.OpenPin Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
OpenPin(Int32) |
Abre una conexión con el pin de E/S de uso general (GPIO) especificado en modo exclusivo. |
OpenPin(Int32, GpioSharingMode) |
Abre la patilla de E/S de uso general (GPIO) especificada en el modo especificado. |
OpenPin(Int32)
Abre una conexión con el pin de E/S de uso general (GPIO) especificado en 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
Número de patilla del pin GPIO que desea abrir. El número de patilla debe ser
- en el intervalo
- disponible para aplicaciones de modo de usuario
Los números de patilla comienzan en 0 y aumentan al número máximo de patillas, que es uno menor que el valor devuelto por GpioController.PinCount.
Qué patillas están disponibles para el modo de usuario depende de la placa de circuito en la que se ejecuta el código. Para obtener información sobre cómo se corresponden los números de patillas físicas, consulte la documentación de la placa de circuito. Las asignaciones de patillas para paneles como Raspberry Pi están disponibles en el Centro para desarrolladores de IoT.
Devoluciones
Patilla GPIO abierta.
- Atributos
Comentarios
Códigos de error:
E_INVALIDARG (0x80070057)
Se especificó un parámetro no válido. Este error se devolverá si el número de patilla está fuera del intervalo. Los números de anclaje comienzan en 0 y aumentan al número máximo de patillas, que es uno menor que el valor devuelto por GpioController.PinCount.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)
El pin no está disponible para las aplicaciones de modo de usuario; está reservado por el sistema. Consulte la documentación de la placa de circuito para averiguar qué patillas están disponibles para las aplicaciones de modo de usuario.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)
El pin está abierto actualmente en un modo de uso compartido incompatible. Por ejemplo:
- El pin ya está abierto en modo GpioSharingMode.Exclusive .
- El pin ya está abierto en modo GpioSharingMode.SharedReadOnly cuando se solicita abrirlo en modo GpioSharingMode.Exclusive .
HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)
El pin está actualmente muxado a una función diferente; por ejemplo, I2C, SPI o UART. Asegúrese de que la patilla no está en uso por otra función.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)
El controlador GPIO devolvió un error. Asegúrese de que el controlador GPIO se está ejecutando y configurado correctamente.
Consulte también
Se aplica a
OpenPin(Int32, GpioSharingMode)
Abre la patilla de E/S de uso general (GPIO) especificada en el 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
Número de patilla del pin GPIO que desea abrir. El número de patilla debe ser
- en el intervalo
- disponible para aplicaciones de modo de usuario
Los números de patilla comienzan en 0 y aumentan al número máximo de patillas, que es uno menor que el valor devuelto por GpioController.PinCount.
Qué patillas están disponibles para el modo de usuario depende de la placa de circuito en la que se ejecuta el código. Para obtener información sobre cómo se corresponden los números de patillas físicas, consulte la documentación de la placa de circuito. Las asignaciones de patillas para paneles como Raspberry Pi están disponibles en el Centro para desarrolladores de IoT.
- sharingMode
- GpioSharingMode
Modo en el que desea abrir la patilla GPIO, que determina si se pueden abrir otras conexiones al pin mientras tiene el pin abierto.
Devoluciones
Patilla GPIO abierta.
- Atributos
Comentarios
Códigos de error:
E_INVALIDARG (0x80070057)
Se especificó un parámetro no válido. Este error se devolverá si el número de patilla está fuera del intervalo. Los números de anclaje comienzan en 0 y aumentan al número máximo de patillas, que es uno menor que el valor devuelto por GpioController.PinCount.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)
El pin no está disponible para las aplicaciones de modo de usuario; está reservado por el sistema. Consulte la documentación de la placa de circuito para averiguar qué patillas están disponibles para las aplicaciones de modo de usuario.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)
El pin está abierto actualmente en un modo de uso compartido incompatible. Por ejemplo:
- El pin ya está abierto en modo GpioSharingMode.Exclusive .
- El pin ya está abierto en modo GpioSharingMode.SharedReadOnly cuando se solicita abrirlo en modo GpioSharingMode.Exclusive .
HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)
El pin está actualmente muxado a una función diferente; por ejemplo, I2C, SPI o UART. Asegúrese de que la patilla no está en uso por otra función.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)
El controlador GPIO devolvió un error. Asegúrese de que el controlador GPIO se está ejecutando y configurado correctamente.