KsAllocateObjectBag, fonction (ks.h)

Article
08/07/2023

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

Voir aussi

KsRemoveItemFromObjectBag

Partager via