GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT 콜백 함수(gpioclx.h)
CLIENT_PreProcessControllerInterrupt 이벤트 콜백 함수는 ISR이 나중에 실행되도록 예약된 경우 즉시 수행해야 하는 GPIO(범용 I/O) 인터럽트 사전 처리를 수행합니다.
통사론
GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT GpioClientPreProcessControllerInterrupt;
NTSTATUS GpioClientPreProcessControllerInterrupt(
[in] PVOID Context,
[in] BANK_ID BankId,
ULONG64 EnabledMask
)
{...}
매개 변수
[in] Context
GPIO 컨트롤러 드라이버의 디바이스 컨텍스트대한 포인터입니다.
[in] BankId
중단 GPIO 핀을 포함하는 은행입니다. N이 GPIO 컨트롤러의 은행 수인 경우 BankId 0~N-1 범위의 정수입니다. GPIO 프레임워크 확장은 이전에 CLIENT_QueryControllerBasicInformation 이벤트 콜백 함수에서 컨트롤러의 은행 수를 획득했습니다. 자세한 내용은 CLIENT_CONTROLLER_BASIC_INFORMATION주의 내용을 참조하세요.
EnabledMask
반환 값
CLIENT_PreProcessControllerInterrupt 함수는 호출에 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.
발언
이 콜백 함수는 선택 사항입니다. GPIO 컨트롤러 드라이버는 PASSIVE_LEVEL 대부분의 인터럽트 처리를 수행하지만 DIRQL에서 인터럽트 초기 처리를 수행해야 하는 경우에만 이 함수를 구현합니다.
일반적으로 GPIO 컨트롤러 드라이버는 DIRQL에서 메모리 매핑된 GPIO 컨트롤러에 액세스할 수 있지만 PASSIVE_LEVEL 직렬로 연결된 GPIO 컨트롤러에만 액세스할 수 있습니다. 그러나 IRQL이 PASSIVE_LEVEL 떨어질 때까지 인터럽트 상태 비트 캡처를 지연하는 경우 일부 직렬로 연결된 GPIO 컨트롤러는 인터럽트 상태 데이터를 잃을 수 있습니다. 나중에 IRQL이 PASSIVE_LEVEL 삭제되면 GPIO 프레임워크 확장(GpioClx)은 드라이버의 CLIENT_QueryActiveInterrupts 콜백 함수를 호출하여 레지스터 콘텐츠를 검색할 수 있습니다.
GPIO 컨트롤러 드라이버는 CLIENT_QueryControllerBasicInformation 콜백 중에 GpioClx에 전달하는 디바이스 정보의 PASSIVE_LEVEL 인터럽트에서 인터럽트 처리해야 하는지 여부를 나타냅니다. 드라이버가 DIRQL에서 컨트롤러의 레지스터에 액세스할 수 있도록 GPIO 컨트롤러가 메모리 매핑된 경우 드라이버는 드라이버가 GpioClx에 전달하는 CLIENT_CONTROLLER_BASIC_INFORMATION 구조체의 Flags 멤버에서 MemoryMappedController 플래그 비트를 설정합니다. 그렇지 않으면 드라이버는 MemoryMappedController = 0을 설정하여 드라이버가 PASSIVE_LEVEL 인터럽트 처리해야 함을 나타냅니다. 자세한 내용은 Passive-Level ISR참조하세요.
드라이버의 CLIENT_PreProcessControllerInterrupt 콜백 함수를 등록하려면 GPIO_CLX_RegisterClient 메서드를 호출합니다. 이 메서드는 입력 매개 변수로 CLIENT_PreProcessControllerInterrupt 함수 포인터를 포함하는 GPIO_CLIENT_REGISTRATION_PACKET 구조체에 대한 포인터를 허용합니다.
예제
CLIENT_PreProcessControllerInterrupt 콜백 함수를 정의하려면 먼저 정의하는 콜백 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 콜백 함수 형식 집합을 제공합니다. 콜백 함수 형식을 사용하여 함수를 선언하면 드라이버 , SDV(정적 드라이버 검증 도구) 및 기타 확인 도구에 대한 코드 분석을데 도움이 되며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.
예를 들어 MyEvtGpioPreProcessInterrupt명명된 CLIENT_PreProcessControllerInterrupt 콜백 함수를 정의하려면 다음 코드 예제와 같이 GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT 함수 형식을 사용합니다.
GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT MyEvtGpioPreProcessInterrupt;
그런 다음 다음과 같이 콜백 함수를 구현합니다.
_Use_decl_annotations_
NTSTATUS
MyEvtGpioPreProcessInterrupt(
PVOID Context
)
{ ... }
GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT 함수 형식은 Gpioclx.h 헤더 파일에 정의됩니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT 함수 형식에 적용되는 주석이 사용되는지 확인합니다. 함수 선언 요구 사항에 대한 자세한 내용은 KMDF 드라이버함수 역할 형식을 사용하여 함수 선언을 참조하세요. Use_decl_annotations대한 자세한 내용은 함수 동작 주석을참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8부터 지원됩니다. |
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | gpioclx.h |
| IRQL | DIRQL에서 호출되었습니다. |