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 드라이버가 실행 중이고 올바르게 구성되었는지 확인합니다.

추가 정보

• Close()
• GpioSharingMode
• TryOpenPin(Int32, GpioSharingMode, GpioPin, GpioOpenStatus)

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 드라이버가 실행 중이고 올바르게 구성되었는지 확인합니다.

추가 정보

• Close()
• GpioSharingMode
• TryOpenPin(Int32, GpioSharingMode, GpioPin, GpioOpenStatus)