Función KsAllocateObjectBag (ks.h)
La función KsAllocateObjectBag crea un contenedor de objetos y lo asocia a un KSDEVICE.
Sintaxis
KSDDKAPI NTSTATUS KsAllocateObjectBag(
[in] PKSDEVICE Device,
[out] KSOBJECT_BAG *ObjectBag
);
Parámetros
[in] Device
Puntero a un KSDEVICE que representa el objeto de dispositivo asociado al contenedor de objetos recién creado.
[out] ObjectBag
Puntero a un KSOBJECT_BAG (la estructura KSOBJECT_BAG es equivalente al tipo PVOID) donde se deposita el contenedor de objetos recién asignado.
Valor devuelto
Devuelve STATUS_SUCCESS si se crea un nuevo contenedor de objetos. Si no se asigna un nuevo contenedor de objetos, devuelve STATUS_INSUFFICIENT_RESOURCES.
Comentarios
Un contenedor de objetos asignado no se elimina automáticamente. El minidriver que llama a KsAllocateObjectBag es responsable de la eliminación del contenedor de objetos. La manera más fácil de hacerlo es llamando a KsFreeObjectBag. Como alternativa, si el minidriver tiene las direcciones de los elementos de la bolsa, el minidriver puede eliminarlos individualmente llamando a KsRemoveItemFromObjectBag.
Para obtener más información, vea Bolsas de objetos.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows XP y en sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluye Ks.h) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |