Função KsRemoveItemFromObjectBag (ks.h)
A funçãoKsRemoveItemFromObjectBag remove um item de um recipiente de objetos.
Sintaxe
KSDDKAPI ULONG KsRemoveItemFromObjectBag(
[in] KSOBJECT_BAG ObjectBag,
[in] PVOID Item,
[in] BOOLEAN Free
);
Parâmetros
[in] ObjectBag
Esse parâmetro especifica o KSOBJECT_BAG (equivalente ao tipo PVOID) do qual remover Item.
[in] Item
Um ponteiro para o item a ser removido do recipiente de objetos solicitado. Observe que Item é removido apenas do recipiente de objetos solicitado. Ele não é removido de nenhum outro recipiente de objeto em que possa estar.
[in] Free
Esse parâmetro especifica se Item deve ser liberado depois de removido do recipiente de objetos especificado. Defina apenas Gratuito para TRUE se Item não estiver contido em nenhum outro recipiente de objetos.
Valor de retorno
Retorna o número de referências em Item. Um valor retornado igual a zero indica que Item não estava em ObjectBag na hora da chamada.
Um valor retornado de um indica que Item foi removido com êxito de ObjectBag e que não estava em nenhum outro recipiente de objetos. Se uma solicitação gratuita nesse caso, o AVStream libera Item usando ExFreePool ou o método Free especificado em KsAddItemToObjectBag tempo de chamada.
Um valor retornado acima indica que o item está presente em outro recipiente de objetos e que ainda há referências nele. Nesse caso, o AVStream removeu o Item do ObjectBag, mas não o liberou independentemente do valor de Gratuito.
Observações
KsRemoveItemFromObjectBag libera Item somente se o número de referências neste item for zero e um gratuito for solicitado.
Para obter mais informações sobre sacos de objetos, consulte Object Bags.
Observe que o mutex associado ao saco deve ser mantido. Para obter mais informações, consulte Mutexes no AVStream.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |