IKsControl::KsEvent メソッド (ksproxy.h)

[アーティクル]
02/29/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 を呼び出したときに通知を受け取ることができます。