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 ピンのピン番号。 ピン番号は次の値にする必要があります。

  • 範囲内
  • usermode アプリケーションで使用できる

ピン番号は 0 から始まり、 GpioController.PinCount によって返される値より 1 つ小さい最大ピン番号まで増やします。

usermode で使用できるピンは、コードが実行されているサーキット ボードによって異なります。 ピン番号と物理ピンの対応については、使用している回路基板のドキュメントを参照してください。 Raspberry Pi などのボードのピン マッピングは、 IoT デベロッパー センターで入手できます。

戻り値

GpioPin

開かれた GPIO ピン。

属性
OverloadAttribute

注釈

エラー コード:

E_INVALIDARG (0x80070057)

無効なパラメーターが指定されました。 このエラーは、ピン番号が範囲外の場合に返されます。 ピン番号は 0 から始まり、 GpioController.PinCount によって返される値より 1 つ小さい最大ピン番号まで増加します。

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 ピンのピン番号。 ピン番号は次の値にする必要があります。

  • 範囲内
  • usermode アプリケーションで使用できる

ピン番号は 0 から始まり、 GpioController.PinCount によって返される値より 1 つ小さい最大ピン番号まで増やします。

usermode で使用できるピンは、コードが実行されているサーキット ボードによって異なります。 ピン番号と物理ピンの対応については、使用している回路基板のドキュメントを参照してください。 Raspberry Pi などのボードのピン マッピングは、 IoT デベロッパー センターで入手できます。

sharingMode
GpioSharingMode

GPIO ピンを開くモード。これは、ピンを開いている間にピンへの他の接続を開くことができるかどうかを決定します。

戻り値

GpioPin

開かれた GPIO ピン。

属性
OverloadAttribute

注釈

エラー コード:

E_INVALIDARG (0x80070057)

無効なパラメーターが指定されました。 このエラーは、ピン番号が範囲外の場合に返されます。 ピン番号は 0 から始まり、 GpioController.PinCount によって返される値より 1 つ小さい最大ピン番号まで増加します。

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 ドライバーが実行され、正しく構成されていることを確認します。

こちらもご覧ください

適用対象