Share via

GpioController.OpenPin Methode

  • Referenz

Definition

Namespace:
Windows.Devices.Gpio

Überlädt

OpenPin(Int32)

Öffnet eine Verbindung mit dem angegebenen GPIO-Pin (General Purpose E/O) im exklusiven Modus.
OpenPin(Int32, GpioSharingMode)

Öffnet den angegebenen GPIO-Pin (General-Purpose E/O) im angegebenen Modus.

OpenPin(Int32)

Bearbeiten

Öffnet eine Verbindung mit dem angegebenen GPIO-Pin (General Purpose E/O) im exklusiven Modus.

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

Parameter

pinNumber
Int32

int

Die Pinnummer des GPIO-Pins, den Sie öffnen möchten. Die Pinnummer muss sein

  • im Bereich
  • für Benutzermodusanwendungen verfügbar

Pinnummern beginnen bei 0, und erhöhen Sie auf die maximale Pinzahl, die eine kleiner als der von GpioController.PinCount zurückgegebene Wert ist.

Welche Pins für den Benutzermodus verfügbar sind, hängt von der Platine ab, auf der der Code ausgeführt wird. Informationen dazu, wie Pinnummern physischen Pins entsprechen, finden Sie in der Dokumentation zu Ihrer Platine. Anheftzuordnungen für Boards wie den Raspberry Pi sind im IoT Developer Center verfügbar.

Gibt zurück

GpioPin

Der geöffnete GPIO-Pin.

Attribute
OverloadAttribute

Hinweise

Fehlercodes:

E_INVALIDARG (0x80070057)

Ein ungültiger Parameter wurde angegeben. Dieser Fehler wird zurückgegeben, wenn sich die Pinnummer außerhalb des Bereichs befindet. Pinnummern beginnen bei 0 und erhöhen sich auf die maximale Pinzahl, die eine kleiner ist als der von GpioController.PinCount zurückgegebene Wert.

HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)

Der Pin ist für Anwendungen im Benutzermodus nicht verfügbar. sie wird vom System reserviert. In der Dokumentation für Ihre Platine erfahren Sie, welche Pins für Benutzermodusanwendungen verfügbar sind.

HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)

Der Pin ist derzeit in einem inkompatiblen Freigabemodus geöffnet. Beispiel:

  • Die Pin ist bereits im GpioSharingMode.Exclusive-Modus geöffnet.
  • Die Pin ist bereits im GpioSharingMode.SharedReadOnly-Modus geöffnet, wenn Sie anfordern, sie im GpioSharingMode.Exclusive-Modus zu öffnen.

HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)

Der Pin ist derzeit zu einer anderen Funktion muxed; z. B. I2C, SPI oder UART. Stellen Sie sicher, dass der Pin nicht von einer anderen Funktion verwendet wird.

HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)

Der GPIO-Treiber hat einen Fehler zurückgegeben. Stellen Sie sicher, dass der GPIO-Treiber ordnungsgemäß ausgeführt und konfiguriert ist.

Weitere Informationen

Gilt für:

OpenPin(Int32, GpioSharingMode)

Bearbeiten

Öffnet den angegebenen GPIO-Pin (General-Purpose E/O) im angegebenen Modus.

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

Parameter

pinNumber
Int32

int

Die Pinnummer des GPIO-Pins, den Sie öffnen möchten. Die Pinnummer muss sein

  • im Bereich
  • für Benutzermodusanwendungen verfügbar

Pinnummern beginnen bei 0, und erhöhen Sie auf die maximale Pinzahl, die eine kleiner als der von GpioController.PinCount zurückgegebene Wert ist.

Welche Pins für den Benutzermodus verfügbar sind, hängt von der Platine ab, auf der der Code ausgeführt wird. Informationen dazu, wie Pinnummern physischen Pins entsprechen, finden Sie in der Dokumentation zu Ihrer Platine. Anheftzuordnungen für Boards wie den Raspberry Pi sind im IoT Developer Center verfügbar.

sharingMode
GpioSharingMode

Der Modus, in dem Sie den GPIO-Pin öffnen möchten, der bestimmt, ob andere Verbindungen mit dem Pin geöffnet werden können, während Sie den Pin geöffnet haben.

Gibt zurück

GpioPin

Der geöffnete GPIO-Pin.

Attribute
OverloadAttribute

Hinweise

Fehlercodes:

E_INVALIDARG (0x80070057)

Ein ungültiger Parameter wurde angegeben. Dieser Fehler wird zurückgegeben, wenn sich die Pinnummer außerhalb des Bereichs befindet. Pinnummern beginnen bei 0 und erhöhen sich auf die maximale Pinzahl, die eine kleiner ist als der von GpioController.PinCount zurückgegebene Wert.

HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)

Der Pin ist für Anwendungen im Benutzermodus nicht verfügbar. sie wird vom System reserviert. In der Dokumentation für Ihre Platine erfahren Sie, welche Pins für Benutzermodusanwendungen verfügbar sind.

HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)

Der Pin ist derzeit in einem inkompatiblen Freigabemodus geöffnet. Beispiel:

  • Die Pin ist bereits im GpioSharingMode.Exclusive-Modus geöffnet.
  • Die Pin ist bereits im GpioSharingMode.SharedReadOnly-Modus geöffnet, wenn Sie anfordern, sie im GpioSharingMode.Exclusive-Modus zu öffnen.

HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)

Der Pin ist derzeit zu einer anderen Funktion muxed; z. B. I2C, SPI oder UART. Stellen Sie sicher, dass der Pin nicht von einer anderen Funktion verwendet wird.

HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)

Der GPIO-Treiber hat einen Fehler zurückgegeben. Stellen Sie sicher, dass der GPIO-Treiber ordnungsgemäß ausgeführt und konfiguriert ist.

Weitere Informationen

Gilt für: