Funzione KsAllocateObjectBag (ks.h)
La funzione KsAllocateObjectBag crea un contenitore di oggetti e la associa a un KSDEVICE.
Sintassi
KSDDKAPI NTSTATUS KsAllocateObjectBag(
[in] PKSDEVICE Device,
[out] KSOBJECT_BAG *ObjectBag
);
Parametri
[in] Device
Puntatore a un KSDEVICE che rappresenta l'oggetto dispositivo associato al contenitore di oggetti appena creato.
[out] ObjectBag
Puntatore a un KSOBJECT_BAG (la struttura KSOBJECT_BAG equivale al tipo PVOID) in cui viene depositato il contenitore di oggetti appena allocato.
Valore restituito
Restituisce STATUS_SUCCESS se viene creato un nuovo contenitore di oggetti. Se non viene allocato un nuovo contenitore di oggetti, restituisce STATUS_INSUFFICIENT_RESOURCES.
Commenti
Un contenitore di oggetti allocato non viene eliminato automaticamente. Il minidriver che chiama KsAllocateObjectBag è responsabile dell'eliminazione del contenitore di oggetti. Il modo più semplice per eseguire questa operazione consiste nel chiamare KsFreeObjectBag. In alternativa, se il minidriver ha gli indirizzi degli elementi nel contenitore, il minidriver può eliminarli singolarmente chiamando KsRemoveItemFromObjectBag.
Per altre informazioni, vedere Contenitori di oggetti.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile nei sistemi operativi Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX. |
| Piattaforma di destinazione | Universale |
| Intestazione | ks.h (include Ks.h) |
| Libreria | Ks.lib |
| IRQL | PASSIVE_LEVEL |