GpioController.OpenPin Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| OpenPin(Int32) |
Apre una connessione al pin di I/O (GPIO) generico specificato in modalità esclusiva. |
| OpenPin(Int32, GpioSharingMode) |
Apre il pin di I/O (GPIO) specificato nella modalità specificata. |
OpenPin(Int32)
Apre una connessione al pin di I/O (GPIO) generico specificato in modalità esclusiva.
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 GpioPinParametri
- pinNumber
-
Int32
int
Numero di pin del pin GPIO da aprire. Il numero di pin deve essere
- in intervallo
- disponibile per le applicazioni usermode
I numeri di aggiunta iniziano a 0 e aumentano al numero massimo di pin, ovvero uno minore del valore restituito da GpioController.PinCount.
I pin disponibili per usermode dipendono dalla scheda del circuito in cui è in esecuzione il codice. Per informazioni sul modo in cui i numeri di pin corrispondono ai pin fisici, vedere la documentazione per la scheda del circuito. I mapping dei pin per le schede, ad esempio Raspberry Pi, sono disponibili nel Centro per sviluppatori IoT.
Restituisce
Pin GPIO aperto.
- Attributi
Commenti
Codici di errore:
E_INVALIDARG (0x80070057)
È stato specificato un parametro non valido. Questo errore verrà restituito se il numero di pin non è compreso nell'intervallo. I numeri di aggiunta iniziano a 0 e aumentano al numero massimo di pin, ovvero uno minore del valore restituito da GpioController.PinCount.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)
Il pin non è disponibile per le applicazioni usermode; è riservato dal sistema. Per scoprire quali pin sono disponibili per le applicazioni usermode, vedere la documentazione relativa alla scheda circuito.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)
Il pin è attualmente aperto in modalità di condivisione non compatibile. Ad esempio:
- Il pin è già aperto in modalità GpioSharingMode.Exclusive .
- Il pin è già aperto in modalità GpioSharingMode.SharedReadOnly quando si richiede di aprirlo in modalità GpioSharingMode.Exclusive .
HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)
Il pin è attualmente muxed a una funzione diversa; ad esempio I2C, SPI o UART. Assicurarsi che il pin non sia in uso da un'altra funzione.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)
Il driver GPIO ha restituito un errore. Assicurarsi che il driver GPIO sia in esecuzione e configurato correttamente.
Vedi anche
Si applica a
OpenPin(Int32, GpioSharingMode)
Apre il pin di I/O (GPIO) specificato nella modalità specificata.
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 GpioPinParametri
- pinNumber
-
Int32
int
Numero di pin del pin GPIO da aprire. Il numero di pin deve essere
- in intervallo
- disponibile per le applicazioni usermode
I numeri di aggiunta iniziano a 0 e aumentano al numero massimo di pin, ovvero uno minore del valore restituito da GpioController.PinCount.
I pin disponibili per usermode dipendono dalla scheda del circuito in cui è in esecuzione il codice. Per informazioni sul modo in cui i numeri di pin corrispondono ai pin fisici, vedere la documentazione per la scheda del circuito. I mapping dei pin per le schede, ad esempio Raspberry Pi, sono disponibili nel Centro per sviluppatori IoT.
- sharingMode
- GpioSharingMode
La modalità in cui si vuole aprire il pin GPIO, che determina se è possibile aprire altre connessioni al pin mentre si dispone del pin aperto.
Restituisce
Pin GPIO aperto.
- Attributi
Commenti
Codici di errore:
E_INVALIDARG (0x80070057)
È stato specificato un parametro non valido. Questo errore verrà restituito se il numero di pin non è compreso nell'intervallo. I numeri di aggiunta iniziano a 0 e aumentano al numero massimo di pin, ovvero uno minore del valore restituito da GpioController.PinCount.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)
Il pin non è disponibile per le applicazioni usermode; è riservato dal sistema. Per scoprire quali pin sono disponibili per le applicazioni usermode, vedere la documentazione relativa alla scheda circuito.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)
Il pin è attualmente aperto in modalità di condivisione non compatibile. Ad esempio:
- Il pin è già aperto in modalità GpioSharingMode.Exclusive .
- Il pin è già aperto in modalità GpioSharingMode.SharedReadOnly quando si richiede di aprirlo in modalità GpioSharingMode.Exclusive .
HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)
Il pin è attualmente muxed a una funzione diversa; ad esempio I2C, SPI o UART. Assicurarsi che il pin non sia in uso da un'altra funzione.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)
Il driver GPIO ha restituito un errore. Assicurarsi che il driver GPIO sia in esecuzione e configurato correttamente.