KeReadStateEvent 함수(wdm.h)
KeReadStateEvent 루틴은 이벤트 개체의 신호 또는 신호가 없는 현재 상태를 반환합니다.
구문
LONG KeReadStateEvent(
[in] PRKEVENT Event
);
매개 변수
[in] Event
호출자가 스토리지를 제공하는 초기화된 이벤트 개체에 대한 포인터입니다.
반환 값
이벤트 개체가 현재 신호됨 상태로 설정된 경우 0이 아닌 값이 반환됩니다. 그렇지 않으면 0이 반환됩니다.
설명
이 루틴은 이벤트의 신호 상태를 폴링하는 효율적인 방법을 제공합니다. KeReadStateEvent 는 이벤트에 대한 액세스를 동기화하지 않고 이벤트의 상태를 읽습니다. KeReadStateEvent의 이벤트 상태 액세스는 이벤트 상태에 대한 액세스를 동기화하는 KeSetEvent 및 KeWaitForSingleObject와 같은 루틴에 의한 액세스가 상호 배타적이라고 가정하지 마세요.
DIRQL에서 드라이버의 인터럽트 서비스 루틴에서 이벤트의 상태를 읽을 수도 있습니다. 드라이버의 이벤트 개체가 상주하고(아마도 디바이스 확장에 있음) 이벤트에 액세스하는 다른 모든 함수가 ISR과 액세스를 동기화합니다.
이벤트 개체에 대한 자세한 내용은 이벤트 개체를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000부터 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | wdm.h(Ntddk.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| DDI 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport), IrqlKeDispatchLte(wdm) |