GPIO_CONNECT_IO_PINS_PARAMETERS 구조체(gpioclx.h)

아티클
08/07/2023

GPIO_CONNECT_IO_PINS_PARAMETERS 구조는 GPIO(범용 I/O) 핀 집합에 대한 논리적 연결을 설명하고 이러한 핀을 데이터 입력 또는 출력으로 구성할지 여부를 지정합니다.

구문

typedef struct _GPIO_CONNECT_IO_PINS_PARAMETERS {
  BANK_ID                    BankId;
  PPIN_NUMBER                PinNumberTable;
  USHORT                     PinCount;
  GPIO_CONNECT_IO_PINS_MODE  ConnectMode;
  UCHAR                      PullConfiguration;
  USHORT                     DebounceTimeout;
  USHORT                     DriveStrength;
  PVOID                      VendorData;
  ULONG                      VendorDataLength;
  GPIO_CONNECT_IO_PINS_FLAGS ConnectFlags;
} GPIO_CONNECT_IO_PINS_PARAMETERS, *PGPIO_CONNECT_IO_PINS_PARAMETERS;

멤버

BankId

GPIO 핀을 포함하는 은행의 식별자입니다. M이 GPIO 컨트롤러의 은행 수인 경우 BankId 는 0~M-1 범위의 정수입니다. GPIO 프레임워크 확장(GpioClx)은 이전에 CLIENT_QueryControllerBasicInformation 이벤트 콜백 함수에서 컨트롤러의 은행 수를 얻었습니다. 자세한 내용은 CLIENT_CONTROLLER_BASIC_INFORMATION 설명을 참조 하세요.

PinNumberTable

PIN_NUMBER 값 배열에 대한 포인터입니다. 각 배열 요소는 연결할 GPIO 핀 수를 지정합니다. N이 이 은행의 핀 수인 경우 핀 번호는 0에서 N-1로 번호가 매겨집니다. 이 배열의 요소 수는 PinCount 멤버에 의해 지정됩니다.

PinCount

PinNumberTable 배열의 요소 수입니다.

ConnectMode

새 연결의 GPIO 핀을 입력 또는 출력으로 구성해야 하는지 여부입니다. 이 매개 변수의 값은 읽기 전용 연결의 경우 ConnectModeInput , 쓰기 전용 연결의 경우 ConnectModeOutput , 읽기/쓰기 연결의 경우 (ConnectModeInput | ConnectModeOutput)입니다. 자세한 내용은 GPIO_CONNECT_IO_PINS_MODE 참조하세요.

PullConfiguration

GPIO 핀을 위로 당기거나 아래로 당기는지 여부입니다. 이 멤버는 일반적으로 다음 시스템 정의 상수 중 하나로 설정됩니다.

GPIO_PIN_PULL_CONFIGURATION_PULLDEFAULT
GPIO_PIN_PULL_CONFIGURATION_PULLUP
GPIO_PIN_PULL_CONFIGURATION_PULLDOWN
GPIO_PIN_PULL_CONFIGURATION_PULLNONE

이러한 상수 중 어느 것도 핀 구성을 적절하게 설명하지 않는 경우 이 멤버를 128-255 범위의 공급업체 정의 상수로 설정할 수 있습니다. 이러한 상수에 대한 자세한 내용은 GPIO_PIN_PULL_CONFIGURATION_XXX 참조하세요.

DebounceTimeout

디버그 시간(10 마이크로초 단위)입니다. 예를 들어 디버그 시간은 5.84밀리초로 584로 지정됩니다. 입력 신호가 기계 스위치에 의해 생성되는 경우 스위치의 금속 접촉은 스위치가 켜지거나 꺼진 후 잠시 동안 반송되는 경향이 있습니다. 디바운스 시간은 신호가 유효한 높거나 낮은 수준으로 해석되기 전에 입력 신호의 수준을 안정적으로 유지해야 하는 최소 시간입니다.

DriveStrength

GPIO 핀의 드라이브 강도(10마이크로암페어 단위)입니다. 예를 들어 1.21밀리암페어의 드라이브 강도는 121로 지정됩니다.

VendorData

하드웨어 플랫폼용 ACPI 펌웨어에서 가져온 공급업체별 데이터를 포함하는 호출자 할당 버퍼에 대한 포인터입니다. 이 데이터는 주변 장치와 GPIO 컨트롤러의 GPIO 핀 집합 간의 데이터 I/O 연결을 설명하는 GPIO 리소스 설명자의 VendorData 필드에서 복사됩니다. 이 멤버는 선택 사항이며 펌웨어가 이 연결에 대한 공급업체별 데이터를 제공하지 않는 경우 NULL로 설정됩니다.

VendorDataLength

VendorData 멤버가 가리키는 데이터 버퍼의 크기(바이트)입니다. VendorData가 NULL이면 VendorDataLength가 0으로 설정됩니다.

ConnectFlags

GPIO 핀의 구성을 제어하는 플래그 집합입니다. 이 멤버에 대한 플래그는 현재 정의되어 있지 않습니다.