KsFreeObjectCreateItemsByContext 関数 (ks.h)
特定のコンテキストを持つすべての作成項目を解放します。
構文
KSDDKAPI NTSTATUS KsFreeObjectCreateItemsByContext(
[in] KSDEVICE_HEADER Header,
[in] PVOID Context
);
パラメーター
[in] Header
作成項目がアタッチされているデバイス ヘッダーをポイントします。
[in] Context
解放するアイテムの作成のコンテキストが含まれます。 このコンテキスト値を持つすべての作成項目は解放されます。
戻り値
アイテムが解放された場合はSTATUS_SUCCESSを返します。それ以外の場合はSTATUS_OBJECT_NAME_NOT_FOUND。
注釈
KsFreeObjectCreateItems のように名前でアイテムを作成する代わりに、この関数は特定のコンテキストを持つすべての作成アイテムを解放します。 たとえば、フィルター ファクトリに関連付けられているすべての作成項目は、コンテキストとしてファクトリを持ち、一度に 1 つではなく、この呼び出しと同時に解放できます。 この関数は、呼び出し元がエントリ作成リストに対する複数の変更をシリアル化していることを前提としないことに注意してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
Header | ks.h (Ks.h を含む) |
Library | Ks.lib |