GpioController.OpenPin Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
OpenPin(Int32) |
Ouvre une connexion à la broche d’E/S à usage général (GPIO) spécifiée en mode exclusif. |
OpenPin(Int32, GpioSharingMode) |
Ouvre la broche d’E/S à usage général (GPIO) spécifiée dans le mode spécifié. |
OpenPin(Int32)
Ouvre une connexion à la broche d’E/S à usage général (GPIO) spécifiée en mode exclusif.
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
Paramètres
- pinNumber
-
Int32
int
Numéro d’épingle de la broche GPIO que vous souhaitez ouvrir. Le numéro d’épingle doit être
- dans la plage
- disponible pour les applications usermode
Les nombres d’épingles commencent à 0 et augmentent jusqu’au nombre maximal de broches, qui est inférieur à la valeur retournée par GpioController.PinCount.
Les broches disponibles pour usermode dépendent de la carte de circuit imprimé sur laquelle le code s’exécute. Pour plus d’informations sur la façon dont les numéros d’épingle correspondent aux broches physiques, consultez la documentation de votre carte de circuit imprimé. Les mappages d’épingles pour les cartes telles que le Raspberry Pi sont disponibles dans le centre de développement IoT.
Retours
Broche GPIO ouverte.
- Attributs
Remarques
Codes d’erreur :
E_INVALIDARG (0x80070057)
Un paramètre non valide a été spécifié. Cette erreur est retournée si le numéro d’épingle est hors limites. Les nombres d’épingles commencent à 0 et augmentent jusqu’au nombre maximal de broches, soit une valeur inférieure à la valeur retournée par GpioController.PinCount.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)
L’épingle n’est pas disponible pour les applications en mode utilisateur ; il est réservé par le système. Consultez la documentation de votre carte de circuit imprimé pour savoir quelles broches sont disponibles pour les applications usermode.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)
L’épingle est actuellement ouverte dans un mode de partage incompatible. Par exemple :
- L’épingle est déjà ouverte en mode GpioSharingMode.Exclusive .
- L’épingle est déjà ouverte en mode GpioSharingMode.SharedReadOnly lorsque vous demandez à l’ouvrir en mode GpioSharingMode.Exclusive .
HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)
La broche est actuellement muxée à une autre fonction ; par exemple I2C, SPI ou UART. Vérifiez que l’épingle n’est pas utilisée par une autre fonction.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)
Le pilote GPIO a retourné une erreur. Vérifiez que le pilote GPIO est en cours d’exécution et configuré correctement.
Voir aussi
S’applique à
OpenPin(Int32, GpioSharingMode)
Ouvre la broche d’E/S à usage général (GPIO) spécifiée dans le mode spécifié.
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
Paramètres
- pinNumber
-
Int32
int
Numéro d’épingle de la broche GPIO que vous souhaitez ouvrir. Le numéro d’épingle doit être
- dans la plage
- disponible pour les applications usermode
Les nombres d’épingles commencent à 0 et augmentent jusqu’au nombre maximal de broches, qui est inférieur à la valeur retournée par GpioController.PinCount.
Les broches disponibles pour usermode dépendent de la carte de circuit imprimé sur laquelle le code s’exécute. Pour plus d’informations sur la façon dont les numéros d’épingle correspondent aux broches physiques, consultez la documentation de votre carte de circuit imprimé. Les mappages d’épingles pour les cartes telles que le Raspberry Pi sont disponibles dans le centre de développement IoT.
- sharingMode
- GpioSharingMode
Mode dans lequel vous souhaitez ouvrir la broche GPIO, qui détermine si d’autres connexions à la broche peuvent être ouvertes pendant que vous avez ouvert l’épingle.
Retours
Broche GPIO ouverte.
- Attributs
Remarques
Codes d’erreur :
E_INVALIDARG (0x80070057)
Un paramètre non valide a été spécifié. Cette erreur est retournée si le numéro d’épingle est hors limites. Les nombres d’épingles commencent à 0 et augmentent jusqu’au nombre maximal de broches, soit une valeur inférieure à la valeur retournée par GpioController.PinCount.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)
L’épingle n’est pas disponible pour les applications en mode utilisateur ; il est réservé par le système. Consultez la documentation de votre carte de circuit imprimé pour savoir quelles broches sont disponibles pour les applications usermode.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)
L’épingle est actuellement ouverte dans un mode de partage incompatible. Par exemple :
- L’épingle est déjà ouverte en mode GpioSharingMode.Exclusive .
- L’épingle est déjà ouverte en mode GpioSharingMode.SharedReadOnly lorsque vous demandez à l’ouvrir en mode GpioSharingMode.Exclusive .
HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)
La broche est actuellement muxée à une autre fonction ; par exemple I2C, SPI ou UART. Vérifiez que l’épingle n’est pas utilisée par une autre fonction.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)
Le pilote GPIO a retourné une erreur. Vérifiez que le pilote GPIO est en cours d’exécution et configuré correctement.