KsAllocateObjectBag, fonction (ks.h)
La fonction KsAllocateObjectBag crée un conteneur d’objets et l’associe à un 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 équivaut au type PVOID) où le conteneur d’objets nouvellement alloué est déposé.
Valeur de retour
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 moyen le plus simple consiste à appeler KsFreeObjectBag. Sinon, si le minidriver a les adresses des éléments du sac, le minidriver peut les supprimer individuellement en appelant KsRemoveItemFromObjectBag.
Pour plus d’informations, consultez sacs d’objets.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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 | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |
| IRQL | PASSIVE_LEVEL |