Função KsFreeObjectCreateItemsByContext (ks.h)

Libera todos os itens de criação com um contexto específico.

Sintaxe

KSDDKAPI NTSTATUS KsFreeObjectCreateItemsByContext(
  [in] KSDEVICE_HEADER Header,
  [in] PVOID           Context
);

Parâmetros

[in] Header

Aponta para o cabeçalho do dispositivo no qual os itens de criação são anexados.

[in] Context

Contém o contexto dos itens de criação a serem liberados. Todos os itens de criação com esse valor de contexto serão liberados.

Retornar valor

Retorna STATUS_SUCCESS se o item foi liberado, caso contrário, STATUS_OBJECT_NAME_NOT_FOUND.

Comentários

Em vez de liberar a criação de itens por nome, como faz KsFreeObjectCreateItems , essa função liberará todos os itens de criação com um contexto específico. Por exemplo, todos os itens de criação associados a uma fábrica de filtros terão a fábrica como contexto e poderão ser liberados simultaneamente com essa chamada em vez de um de cada vez. Observe que essa função não pressupõe que o chamador está serializando várias alterações na lista de entrada de criação.

Requisitos

Confira também

KsFreeObjectCreateItem