KsFreeEventList 関数 (ks.h)

KsFreeEventList 関数は、指定したリストからすべてのイベントを解放します。ただし、これらのイベントは KSEVENT_ENTRY 構造体で構成されていることを前提とします。 この関数は、PASSIVE_LEVELでのみ呼び出すことができます。

構文

KSDDKAPI VOID KsFreeEventList(
  [in]      PFILE_OBJECT      FileObject,
  [in, out] PLIST_ENTRY       EventsList,
  [in]      KSEVENTS_LOCKTYPE EventsFlags,
  [in]      PVOID             EventsLock
);

パラメーター

[in] FileObject

コンテキスト情報の削除関数に渡されるファイル オブジェクトを指定します。 関連付けられているファイル オブジェクトは、イベントを有効にするときに最初に指定されたファイル オブジェクトと比較するために使用されます。 これにより、ファイル オブジェクトによって区別される複数のクライアントに対して 1 つのイベント リストを使用できます。

[in, out] EventsList

解放する項目の一覧の先頭KSEVENT_ENTRYポイントします。 リスト上のイベントが現在無効になっている場合は、渡されます。 処理中に新しい要素がリストに追加されると、解放されない可能性があります。

[in] EventsFlags

イベント リストへのアクセスに使用する除外ロックの種類を指定する KSEVENTS_LOCKTYPE フラグを指定します。 フラグが設定されていない場合、ロックは行われません。

[in] EventsLock

リスト上の要素へのアクセスを同期するために使用されます。 要素にアクセスすると、削除済みとしてマークされるため、後続の削除要求は失敗します。 ロックは、削除関数 (ある場合) を呼び出した後に解放されます。 削除関数は、リストから要素を実際に削除する前に、イベント生成と同期する必要があります。

戻り値

何一つ

備考

KsFreeEventList 関数は remove ハンドラーを呼び出し、各イベント KsDiscardEvent を呼び出します。 呼び出し元がイベント所有者であるとは想定していません。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
ヘッダー	ks.h (Ks.h を含む)
ライブラリ	Ks.lib

関連項目

KsDiscardEvent を する