KsDiscardEvent 함수(ks.h)

KsDiscardEvent 함수는 개체가 역참조된 후 이벤트 항목에서 사용하는 메모리를 삭제합니다. 이벤트 소유자가 사용하지 않도록 설정하지 않은 이벤트를 수동으로 사용하지 않도록 설정할 때 함수를 호출할 수 있습니다( KsFreeEventList 함수를 호출하여 이벤트를 사용하지 않도록 설정). 예를 들어 이벤트를 비동기적으로 사용하도록 설정하는 데 실패하고 이벤트 항목을 삭제해야 하는 경우 함수를 호출할 수 있습니다.

구문

KSDDKAPI VOID KsDiscardEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

매개 변수

[in] EventEntry

삭제할 항목에 대한 포인터를 지정합니다. 이 함수를 성공적으로 호출한 후에는 이 포인터가 더 이상 유효하지 않습니다.

반환 값

없음

설명

일반적으로 KsDiscardEvent 함수는 이벤트를 사용하지 않도록 설정하라는 요청이 발생할 때 KsDisableEvent 함수 또는 이벤트 목록 해제 요청이 발생할 때 KsFreeEventList 함수에 의해 자동으로 호출됩니다. 이 함수는 PASSIVE_LEVEL 호출할 수 있습니다.

요구 사항

추가 정보

KsDisableEvent

KsFreeEventList