共用方式為

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所傳回的值。

哪些針腳可供 usermode 使用，取決於程式碼執行所在的線路板。 如需針腳編號如何對應至實體針腳的資訊，請參閱線路板的檔。 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)

針腳目前在不相容的共用模式中開啟。 例如：

  • Pin 已在 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所傳回的值。

哪些針腳可供 usermode 使用，取決於程式碼執行所在的線路板。 如需針腳編號如何對應至實體針腳的資訊，請參閱線路板的檔。 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)

針腳目前在不相容的共用模式中開啟。 例如：

  • Pin 已在 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 驅動程式正在執行並正確設定。

另請參閱

適用於