다음을 통해 공유

GpioController.OpenPin 메서드

  • 참조

정의

네임스페이스:
Windows.Devices.Gpio

오버로드

OpenPin(Int32)

배타적 모드에서 지정된 GPIO(범용 I/O) 핀에 대한 연결을 엽니다.
OpenPin(Int32, GpioSharingMode)

지정된 모드에서 지정된 GPIO(범용 I/O) 핀을 엽니다.

OpenPin(Int32)

편집

배타적 모드에서 지정된 GPIO(범용 I/O) 핀에 대한 연결을 엽니다.

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 핀의 핀 번호입니다. 핀 번호는

  • 범위 내
  • usermode 애플리케이션에서 사용 가능

핀 번호는 0부터 시작하여 GpioController.PinCount에서 반환하는 값보다 작은 최대 핀 번호로 증가합니다.

usermode에 사용할 수 있는 핀은 코드가 실행되는 회로 보드에 따라 달라집니다. 핀 번호가 실제 핀에 해당하는 방법에 대한 자세한 내용은 회로 보드 설명서를 참조하세요. Raspberry Pi와 같은 보드에 대한 핀 매핑은 IoT 개발자 센터에서 사용할 수 있습니다.

반환

GpioPin

열린 GPIO 핀입니다.

특성
OverloadAttribute

설명

오류 코드:

E_INVALIDARG(0x80070057)

잘못된 매개 변수가 지정되었습니다. 핀 번호가 범위를 벗어나면 이 오류가 반환됩니다. 핀 번호는 0에서 시작하여 GpioController.PinCount에서 반환하는 값보다 작은 최대 핀 번호로 증가합니다.

HRESULT_FROM_WIN32(ERROR_NOT_FOUND)(0x80070490)

핀은 usermode 애플리케이션에서 사용할 수 없습니다. 시스템에서 예약합니다. 회로 보드에 대한 설명서를 참조하여 usermode 애플리케이션에서 사용할 수 있는 핀을 확인합니다.

HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)(0x80070020)

핀은 현재 호환되지 않는 공유 모드로 열려 있습니다. 예를 들면 다음과 같습니다.

  • 핀이 GpioSharingMode.Exclusive 모드에서 이미 열려 있습니다.
  • GpioSharingMode.Exclusive 모드에서 열기를 요청할 때 핀이 GpioSharingMode.SharedReadOnly 모드에서 이미 열려 있습니다.

HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE)(0x80073bde)

핀은 현재 다른 함수에 muxed되어 있습니다. 예를 들어 I2C, SPI 또는 UART입니다. 핀이 다른 함수에서 사용되고 있지 않은지 확인합니다.

HRESULT_FROM_WIN32(ERROR_GEN_FAILURE)(0x8007001f)

GPIO 드라이버가 오류를 반환했습니다. GPIO 드라이버가 실행 중이고 올바르게 구성되었는지 확인합니다.

추가 정보

적용 대상

OpenPin(Int32, GpioSharingMode)

편집

지정된 모드에서 지정된 GPIO(범용 I/O) 핀을 엽니다.

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 핀의 핀 번호입니다. 핀 번호는

  • 범위 내
  • usermode 애플리케이션에서 사용 가능

핀 번호는 0부터 시작하여 GpioController.PinCount에서 반환하는 값보다 작은 최대 핀 번호로 증가합니다.

usermode에 사용할 수 있는 핀은 코드가 실행되는 회로 보드에 따라 달라집니다. 핀 번호가 실제 핀에 해당하는 방법에 대한 자세한 내용은 회로 보드 설명서를 참조하세요. Raspberry Pi와 같은 보드에 대한 핀 매핑은 IoT 개발자 센터에서 사용할 수 있습니다.

sharingMode
GpioSharingMode

GPIO 핀을 열려는 모드로, 핀이 열려 있는 동안 핀에 대한 다른 연결을 열 수 있는지 여부를 결정합니다.

반환

GpioPin

열린 GPIO 핀입니다.

특성
OverloadAttribute

설명

오류 코드:

E_INVALIDARG(0x80070057)

잘못된 매개 변수가 지정되었습니다. 핀 번호가 범위를 벗어나면 이 오류가 반환됩니다. 핀 번호는 0에서 시작하여 GpioController.PinCount에서 반환하는 값보다 작은 최대 핀 번호로 증가합니다.

HRESULT_FROM_WIN32(ERROR_NOT_FOUND)(0x80070490)

핀은 usermode 애플리케이션에서 사용할 수 없습니다. 시스템에서 예약합니다. 회로 보드에 대한 설명서를 참조하여 usermode 애플리케이션에서 사용할 수 있는 핀을 확인합니다.

HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)(0x80070020)

핀은 현재 호환되지 않는 공유 모드로 열려 있습니다. 예를 들면 다음과 같습니다.

  • 핀이 GpioSharingMode.Exclusive 모드에서 이미 열려 있습니다.
  • GpioSharingMode.Exclusive 모드에서 열기를 요청할 때 핀이 GpioSharingMode.SharedReadOnly 모드에서 이미 열려 있습니다.

HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE)(0x80073bde)

핀은 현재 다른 함수에 muxed되어 있습니다. 예를 들어 I2C, SPI 또는 UART입니다. 핀이 다른 함수에서 사용되고 있지 않은지 확인합니다.

HRESULT_FROM_WIN32(ERROR_GEN_FAILURE)(0x8007001f)

GPIO 드라이버가 오류를 반환했습니다. GPIO 드라이버가 실행 중이고 올바르게 구성되었는지 확인합니다.

추가 정보

적용 대상