KsGenerateEvent 함수(ks.h)

아티클
02/26/2024

KsGenerateEvent 함수는 이벤트 항목 구조가 지정된 경우 표준 이벤트 알림을 생성합니다.

구문

KSDDKAPI NTSTATUS KsGenerateEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

매개 변수

[in] EventEntry

이벤트 데이터를 참조하는 이벤트 항목 구조를 지정합니다. 이 정보는 수행할 알림 유형을 결정하는 데 사용됩니다. 알림 유형이 미리 정의된 표준 중 하나가 아니면 오류가 반환됩니다. 단일 비귀귀 이벤트의 경우 함수에서 반환할 때 이 항목이 유효하지 않습니다. 따라서 이벤트 목록을 열거하는 모든 코드는 이 이벤트를 함수에 전달하기 전에 목록에서 다음 이벤트를 획득하기 위해 미리 증가해야 합니다.

반환 값

KsGenerateEvent 함수는 성공하거나 실패하면 예외 또는 메모리 오류를 반환하는 STATUS_SUCCESS 반환합니다.

설명

디바이스는 KSEVENT_ENTRY 구조를 사용하여 이벤트 알림이 생성되는 시기를 확인한 다음, 이 함수를 사용하여 실제 알림을 수행합니다. KsGenerateEvent 는 모든 IRQL에서 호출할 수 있습니다. DISPATCH_LEVEL 위에서 호출하면 DPC에서 이벤트 신호가 비동기적으로 수행됩니다.