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 은행은 F0 전원 상태에 있어야 IOCTL을 처리할 수 있습니다. 요소가 FALSE 경우 해당 은행은 F0 전원 상태에 있을 필요가 없습니다.
발언
명명되지 않은 공용 구조체에는 다양한 유형의 특성 요청에 대한 출력 정보가 포함됩니다. 해당 CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT 구조체의 RequestType 멤버는 이러한 멤버 중 어떤 멤버가 사용되는지 결정합니다.
CLIENT_QuerySetControllerInformation 함수의 선택적 OutputBuffer 매개 변수는 호출자가 할당한 CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT 구조체에 대한 포인터입니다. OutputBuffer NULL이 아닌 경우 함수는 요청된 특성 정보를 이 구조에 씁니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8부터 지원됩니다. |
| 헤더 | gpioclx.h |