CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT 구조체(gpioclx.h)
CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT 구조에는 GPIO 프레임워크 확장(GpioClx)에서 요청한 GPIO(범용 I/O) 컨트롤러 특성 집합이 포함되어 있습니다.
구문
typedef struct _CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT {
USHORT Version;
USHORT Size;
union {
CLIENT_QUERY_BANK_POWER_INFORMATION_OUTPUT BankPowerInformation;
struct {
ULONG ResourceMapping[ANYSIZE_ARRAY];
} BankInterruptBinding;
struct {
BOOLEAN Mapping[ANYSIZE_ARRAY];
} ControllerFunctionBankMapping;
};
} CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT, *PCLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT;
멤버
Version
이 구조체의 버전 번호를 지정합니다.
Size
이 구조체의 크기(바이트)를 지정합니다.
BankPowerInformation
해당 CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT 구조체의 BankPowerInformation.BankId 멤버로 식별되는 GPIO 은행의 전원 특성을 포함하는 CLIENT_QUERY_BANK_POWER_INFORMATION_OUTPUT 구조체입니다.
BankInterruptBinding
GPIO 은행에 대한 인터럽트 리소스 바인딩에 대한 정보를 포함하는 구조체입니다.
BankInterruptBinding.ResourceMapping[ANYSIZE_ARRAY]
인터럽트 리소스 번호의 배열입니다. 배열의 요소 수는 GPIO 뱅크 수와 같습니다. N이 GPIO 컨트롤러의 은행 수인 경우 은행은 0에서 N-1로 번호가 매겨집니다. 배열의 요소 0에는 bank 0에 바인딩된 인터럽트 리소스 번호가 포함되고 요소 1에는 bank 1에 바인딩된 인터럽트 리소스 번호가 포함됩니다. 둘 이상의 인터럽트 리소스를 GPIO 은행에 바인딩할 수 없지만 둘 이상의 은행이 인터럽트 리소스를 공유할 수 있습니다. 은행이 인터럽트 리소스에 바인딩되지 않은 경우 해당 배열 요소는 GPIO_BANK_INTERRUPT_BINDING_RESERVED_INDEX(0xffff )로 설정됩니다.
인터럽트 리소스는 리소스 번호로 식별됩니다. 이는 CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT 구조체의 BankInterruptBinding 멤버에 있는 ResourcesTranslated 또는 ResourcesRaw 리소스 목록에 있는 리소스의 인덱스입니다. 목록에 M 리소스가 포함된 경우 리소스 번호는 0에서 M-1로 지정됩니다. 리소스 목록의 인터럽트 리소스에 해당하는 리소스 번호만 ResourceMapping 배열에 표시할 수 있습니다.
ControllerFunctionBankMapping
I/O 제어 요청(IOCTL)을 처리하기 위해 F0(완전 켜기) 전원 상태여야 하는 GPIO 은행에 대한 정보를 포함하는 구조체입니다.
ControllerFunctionBankMapping.Mapping[ANYSIZE_ARRAY]
GPIO 은행에 필요한 F0 전원 상태의 매핑을 나타내는 BOOLEAN 값의 배열입니다. 배열의 요소 수는 GPIO 뱅크 수와 같습니다. N이 GPIO 컨트롤러의 은행 수인 경우 은행은 0에서 N-1로 번호가 매겨집니다. 배열의 요소 0에는 bank 0에 대한 매핑이 포함되고 요소 1에는 bank 1에 대한 매핑이 포함됩니다. 요소가 TRUE이면 해당 GPIO 뱅크가 IOCTL을 처리하려면 F0 전원 상태여야 합니다. 요소가 FALSE이면 해당 뱅크가 F0 전원 상태에 있을 필요가 없습니다.
설명
명명되지 않은 공용 구조체에는 다양한 유형의 특성 요청에 대한 출력 정보가 포함됩니다. 해당 CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT 구조체의 RequestType 멤버는 이러한 멤버 중 어떤 멤버가 사용되는지 결정합니다.
CLIENT_QuerySetControllerInformation 함수의 선택적 OutputBuffer 매개 변수는 호출자가 할당한 CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT 구조체에 대한 포인터입니다. OutputBuffer가 NULL이 아닌 경우 함수는 요청된 특성 정보를 이 구조체에 씁니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 부터 지원합니다. |
| 머리글 | gpioclx.h |