GpioController.OpenPin Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| OpenPin(Int32) |
Открывает подключение к указанному контакту ввода-вывода общего назначения (GPIO) в монопольном режиме. |
| OpenPin(Int32, GpioSharingMode) |
Открывает указанный контакт ввода-вывода общего назначения (GPIO) в указанном режиме. |
OpenPin(Int32)
Открывает подключение к указанному контакту ввода-вывода общего назначения (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, который требуется открыть. Номер закрепления должен быть
- в диапазоне
- доступно для приложений пользовательского режима
Числа закрепления начинаются с 0 и увеличиваются до максимального числа закрепления, которое на один меньше значения, возвращаемого GpioController.PinCount.
Доступные для пользовательского режима контакты зависят от платы, на которой выполняется код. Сведения о том, как номера контактов соответствуют физическим контактам, см. в документации по плате. Сопоставления закреплений для досок, таких как Raspberry Pi, доступны в Центре разработчиков Интернета вещей.
Возвращаемое значение
Открытый контакт GPIO.
- Атрибуты
Комментарии
Коды ошибок:
E_INVALIDARG (0x80070057)
Указан недопустимый параметр. Эта ошибка будет возвращена, если номер пин-кода выходит за пределы диапазона. Числа закрепления начинаются с 0 и увеличиваются до максимального числа закрепления, которое на один меньше значения, возвращаемого GpioController.PinCount.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)
Закрепление недоступно для приложений пользовательского режима; он резервируется системой. Сведения о том, какие контакты доступны для приложений пользовательского режима, см. в документации по плате.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)
В настоящее время закрепление открыто в несовместимом режиме общего доступа. Пример:
- Контакт уже открыт в режиме GpioSharingMode.Exclusive .
- Контакт уже открыт в режиме GpioSharingMode.SharedReadOnly при запросе на открытие в режиме GpioSharingMode.Exclusive .
HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)
В настоящее время закрепление мультиплексируется в другую функцию; например I2C, SPI или UART. Убедитесь, что закрепление не используется другой функцией.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)
Драйвер GPIO вернул ошибку. Убедитесь, что драйвер GPIO работает и настроен правильно.
См. также раздел
Применяется к
OpenPin(Int32, GpioSharingMode)
Открывает указанный контакт ввода-вывода общего назначения (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, который требуется открыть. Номер закрепления должен быть
- в диапазоне
- доступно для приложений пользовательского режима
Числа закрепления начинаются с 0 и увеличиваются до максимального числа закрепления, которое на один меньше значения, возвращаемого GpioController.PinCount.
Доступные для пользовательского режима контакты зависят от платы, на которой выполняется код. Сведения о том, как номера контактов соответствуют физическим контактам, см. в документации по плате. Сопоставления закреплений для досок, таких как Raspberry Pi, доступны в Центре разработчиков Интернета вещей.
- sharingMode
- GpioSharingMode
Режим, в котором требуется открыть закрепление GPIO, который определяет, можно ли открывать другие подключения к закреплению, пока он открыт.
Возвращаемое значение
Открытый контакт GPIO.
- Атрибуты
Комментарии
Коды ошибок:
E_INVALIDARG (0x80070057)
Указан недопустимый параметр. Эта ошибка будет возвращена, если номер пин-кода выходит за пределы диапазона. Числа закрепления начинаются с 0 и увеличиваются до максимального числа закрепления, которое на один меньше значения, возвращаемого GpioController.PinCount.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)
Закрепление недоступно для приложений пользовательского режима; он резервируется системой. Сведения о том, какие контакты доступны для приложений пользовательского режима, см. в документации по плате.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)
В настоящее время закрепление открыто в несовместимом режиме общего доступа. Пример:
- Контакт уже открыт в режиме GpioSharingMode.Exclusive .
- Контакт уже открыт в режиме GpioSharingMode.SharedReadOnly при запросе на открытие в режиме GpioSharingMode.Exclusive .
HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)
В настоящее время закрепление мультиплексируется в другую функцию; например I2C, SPI или UART. Убедитесь, что закрепление не используется другой функцией.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)
Драйвер GPIO вернул ошибку. Убедитесь, что драйвер GPIO работает и настроен правильно.