Función KsRemoveItemFromObjectBag (ks.h)
La funciónKsRemoveItemFromObjectBag quita un elemento de un contenedor de objetos.
Sintaxis
KSDDKAPI ULONG KsRemoveItemFromObjectBag(
[in] KSOBJECT_BAG ObjectBag,
[in] PVOID Item,
[in] BOOLEAN Free
);
Parámetros
[in] ObjectBag
Este parámetro especifica el KSOBJECT_BAG (equivalente al tipo PVOID) del que se va a quitar Item.
[in] Item
Puntero al elemento que se va a quitar del contenedor de objetos solicitado. Tenga en cuenta que item solo se quita del contenedor de objetos solicitado. No se quita de ninguna otra bolsa de objetos en la que pueda estar.
[in] Free
Este parámetro especifica si elemento debe liberarse una vez que se haya quitado del contenedor de objetos especificado. Establezca solo Gratis en TRUE si Item no está incluido en ningún otro contenedor de objetos.
Valor devuelto
Devuelve el número de referencias en elemento. Un valor devuelto de cero indica que Item no estaba en ObjectBag en el momento de la llamada.
Un valor devuelto de uno indica que Item se quitó correctamente de ObjectBag y que no estaba en ningún otro contenedor de objetos. Si se solicitó un gratis en este caso, AVStream libera Item mediante ExFreePool o el método Free especificado en KsAddItemToObjectBag tiempo de llamada.
Un valor devuelto por encima de uno indica que el elemento está presente en otro contenedor de objetos y que todavía hay referencias en él. En este caso, AVStream quitó Item de ObjectBag, pero no lo liberó independientemente del valor de Free.
Observaciones
KsRemoveItemFromObjectBag libera Item solo si el número de referencias de este elemento es cero y se solicitó un gratis.
Para obtener más información sobre las bolsas de objetos, vea bolsas de objetos.
Tenga en cuenta que la exclusión mutua asociada a la bolsa debe mantenerse. Para obtener más información, vea Exclusión mutua en AVStream.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| de la plataforma de destino de | Universal |
| encabezado de | ks.h (incluya Ks.h) |
| biblioteca de | Ks.lib |
| irQL | PASSIVE_LEVEL |