IKsControl::KsEvent 메서드(ksproxy.h)

아티클
02/26/2024

KsEvent 메서드는 이벤트 집합에서 사용할 수 있는 다른 정의된 지원 작업과 함께 이벤트를 사용하거나 사용하지 않도록 설정합니다.

구문

HRESULT KsEvent(
  [in, optional] PKSEVENT Event,
  [in]           ULONG    EventLength,
  [in, out]      LPVOID   EventData,
  [in]           ULONG    DataLength,
  [in, out]      ULONG    *BytesReturned
);

매개 변수

[in, optional] Event

이벤트를 사용하도록 설정하는 이벤트를 설명하는 KSEVENT 구조체에 대한 포인터이고 NULL 은 이벤트를 사용하지 않도록 설정합니다.

[in] EventLength

이벤트가 사용하도록 설정된 경우 Event 의 버퍼 크기(바이트)와 이벤트가 사용하지 않도록 설정된 경우 0입니다.

[in, out] EventData

이벤트에 대한 데이터를 포함하고 이벤트에 대한 데이터를 수신하는 버퍼 공간을 포함하는 KSEVENTDATA 구조체에 대한 포인터입니다.

[in] DataLength

EventData의 버퍼 크기(바이트)입니다.

[in, out] BytesReturned

KsEvent가 EventData의 버퍼에 저장하는 데이터의 크기(바이트)를 수신하는 변수에 대한 포인터입니다.

반환 값

성공하면 NOERROR를 반환합니다. 그렇지 않으면 은 오류 코드를 반환합니다. 호출이 성공하면 이벤트는 드라이버의 이벤트 목록에 있습니다.

설명

이벤트를 사용하지 않도록 설정하려면 이벤트를NULL로, EventLength 를 0으로 설정하고 , EventData 를 이전에 이벤트를 사용하도록 설정하는 데 사용된 KSEVENTDATA 구조체에 대한 포인터로 설정합니다.

IKsControl::KsEvent의 EventData 매개 변수에는 EventHandle.Event의 핸들이 포함되어 있습니다. 미니드라이버가 KsXxxGenerateEvents 또는 StreamClassStreamNotification을 호출할 때 핸들이 사용 가능해질 때까지 기다렸다가 알림을 받을 수 있습니다.