GpioController.OpenPin 方法

  • 参考

定义

命名空间:
Windows.Devices.Gpio

重载

OpenPin(Int32)

在独占模式下打开与指定的常规用途 I/O (GPIO) 引脚的连接。
OpenPin(Int32, GpioSharingMode)

在指定模式下打开指定的常规用途 I/O (GPIO) 引脚。

OpenPin(Int32)

编辑

在独占模式下打开与指定的常规用途 I/O (GPIO) 引脚的连接。

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

参数

pinNumber
Int32

int

要打开的 GPIO 引脚的引脚编号。 引脚编号必须为

  • 在范围内
  • 可用于用户模式应用程序

引脚编号从 0 开始，增加到最大引脚数，比 GpioController.PinCount 返回的值少一个。

哪些引脚可用于用户模式取决于运行代码的线路板。 有关引脚编号如何对应于物理引脚的信息，请参阅线路板的文档。 IoT 开发人员中心提供 Raspberry Pi 等板的引脚映射。

返回

GpioPin

打开的 GPIO 引脚。

属性
OverloadAttribute

注解

错误代码：

E_INVALIDARG (0x80070057)

指定的参数无效。 如果引脚编号在范围外，将返回此错误。 固定编号从 0 开始，增加到最大引脚数，比 GpioController.PinCount 返回的值少一个。

HRESULT_FROM_WIN32 (ERROR_NOT_FOUND) (0x80070490)

该引脚不可用于用户模式应用程序;它由系统保留。 请参阅线路板的文档，了解哪些引脚可用于用户模式应用程序。

HRESULT_FROM_WIN32 (ERROR_SHARING_VIOLATION) (0x80070020)

引脚当前在不兼容的共享模式下打开。 例如：

  • 引脚已在 GpioSharingMode.Exclusive 模式下打开。
  • 当你请求在 GpioSharingMode.Exclusive 模式下打开引脚时，该引脚已在 GpioSharingMode.SharedReadOnly 模式下打开。

HRESULT_FROM_WIN32 (ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)

引脚当前已复用到其他函数;例如 I2C、SPI 或 UART。 确保引脚未由另一个函数使用。

HRESULT_FROM_WIN32 (ERROR_GEN_FAILURE) (0x8007001f)

GPIO 驱动程序返回错误。 确保 GPIO 驱动程序正在运行并正确配置。

另请参阅

适用于

OpenPin(Int32, GpioSharingMode)

编辑

在指定模式下打开指定的常规用途 I/O (GPIO) 引脚。

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

参数

pinNumber
Int32

int

要打开的 GPIO 引脚的引脚编号。 引脚编号必须为

  • 在范围内
  • 可用于用户模式应用程序

引脚编号从 0 开始，增加到最大引脚数，比 GpioController.PinCount 返回的值少一个。

哪些引脚可用于用户模式取决于运行代码的线路板。 有关引脚编号如何对应于物理引脚的信息，请参阅线路板的文档。 IoT 开发人员中心提供 Raspberry Pi 等板的引脚映射。

sharingMode
GpioSharingMode

要打开 GPIO 引脚的模式，该模式确定在引脚打开时是否可以打开与引脚的其他连接。

返回

GpioPin

打开的 GPIO 引脚。

属性
OverloadAttribute

注解

错误代码：

E_INVALIDARG (0x80070057)

指定的参数无效。 如果引脚编号在范围外，将返回此错误。 固定编号从 0 开始，增加到最大引脚数，比 GpioController.PinCount 返回的值少一个。

HRESULT_FROM_WIN32 (ERROR_NOT_FOUND) (0x80070490)

该引脚不可用于用户模式应用程序;它由系统保留。 请参阅线路板的文档，了解哪些引脚可用于用户模式应用程序。

HRESULT_FROM_WIN32 (ERROR_SHARING_VIOLATION) (0x80070020)

引脚当前在不兼容的共享模式下打开。 例如：

  • 引脚已在 GpioSharingMode.Exclusive 模式下打开。
  • 当你请求在 GpioSharingMode.Exclusive 模式下打开引脚时，该引脚已在 GpioSharingMode.SharedReadOnly 模式下打开。

HRESULT_FROM_WIN32 (ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)

引脚当前已复用到其他函数;例如 I2C、SPI 或 UART。 确保引脚未由另一个函数使用。

HRESULT_FROM_WIN32 (ERROR_GEN_FAILURE) (0x8007001f)

GPIO 驱动程序返回错误。 确保 GPIO 驱动程序正在运行并正确配置。

另请参阅

适用于