GpioController.OpenPin Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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)
Ö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 GpioPinParameter
- 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
Der geöffnete GPIO-Pin.
- Attribute
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)
Ö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 GpioPinParameter
- 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
Der geöffnete GPIO-Pin.
- Attribute
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.