KsAllocateObjectBag, fonction (ks.h)
La fonction KsAllocateObjectBag crée un conteneur d’objets et l’associe à un objet KSDEVICE.
Syntaxe
KSDDKAPI NTSTATUS KsAllocateObjectBag(
[in] PKSDEVICE Device,
[out] KSOBJECT_BAG *ObjectBag
);
Paramètres
[in] Device
Pointeur vers un KSDEVICE représentant l’objet d’appareil associé au conteneur d’objets nouvellement créé.
[out] ObjectBag
Pointeur vers un KSOBJECT_BAG (la structure KSOBJECT_BAG est équivalente au type PVOID) où le conteneur d’objets nouvellement alloué est déposé.
Valeur retournée
Retourne STATUS_SUCCESS si un conteneur d’objets est créé. Si un nouveau conteneur d’objets n’est pas alloué, il retourne STATUS_INSUFFICIENT_RESOURCES.
Remarques
Un conteneur d’objets alloué n’est pas supprimé automatiquement. Le minidriver appelant KsAllocateObjectBag est responsable de la suppression du conteneur d’objets. Pour ce faire, le plus simple consiste à appeler KsFreeObjectBag. Sinon, si le minidriver a les adresses des éléments dans le sac, le minidriver peut les supprimer individuellement en appelant KsRemoveItemFromObjectBag.
Pour plus d’informations, consultez Sacs d’objets.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX. |
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |
| IRQL | PASSIVE_LEVEL |