Função KsAllocateObjectBag (ks.h)
A função KsAllocateObjectBag cria um recipiente de objetos e a associa a um KSDEVICE.
Sintaxe
KSDDKAPI NTSTATUS KsAllocateObjectBag(
[in] PKSDEVICE Device,
[out] KSOBJECT_BAG *ObjectBag
);
Parâmetros
[in] Device
Um ponteiro para um KSDEVICE que representa o objeto de dispositivo associado ao recipiente de objetos recém-criado.
[out] ObjectBag
Um ponteiro para um KSOBJECT_BAG (a estrutura KSOBJECT_BAG é equivalente ao tipo PVOID) em que o recipiente de objeto recém-alocado é depositado.
Retornar valor
Retorna STATUS_SUCCESS se um novo recipiente de objetos for criado. Se um novo recipiente de objetos não for alocado, ele retornará STATUS_INSUFFICIENT_RESOURCES.
Comentários
Um recipiente de objetos alocado não é excluído automaticamente. O minidriver que chama KsAllocateObjectBag é responsável pela exclusão do recipiente de objetos. A maneira mais fácil de fazer isso é chamando KsFreeObjectBag. Como alternativa, se o minidriver tiver os endereços dos itens na bolsa, o minidriver poderá excluí-los individualmente chamando KsRemoveItemFromObjectBag.
Para obter mais informações, consulte Sacos de objeto.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| Biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |