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 gratuitos. Todos os itens de criação com esse valor de contexto serão liberados.
Valor de retorno
Retorna STATUS_SUCCESS se o item foi liberado, caso contrário, STATUS_OBJECT_NAME_NOT_FOUND.
Observações
Em vez de liberar itens de criação por nome como KsFreeObjectCreateItems faz, 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
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |