KsAddItemToObjectBag, fonction (ks.h)

Article
02/26/2024

La fonction KsAddItemToObjectBag ajoute un objet ou un bloc de mémoire au sac d’objets donné.

Syntaxe

KSDDKAPI NTSTATUS KsAddItemToObjectBag(
  [in]           KSOBJECT_BAG           ObjectBag,
  [in]           __drv_aliasesMem PVOID Item,
  [in, optional] PFNKSFREE              Free
);

Paramètres

[in] ObjectBag

Le KSOBJECT_BAG (équivalent au type PVOID) auquel ajouter l’élément demandé. Chaque objet AVStream (par exemple, KSFILTER et KSPIN) contient un membre appelé Bag. Transmettez ce membre dans ce paramètre.

[in] Item

Pointeur vers l’élément à ajouter au sac d’objets.

[in, optional] Free

Fonction appelée lorsque l’élément est supprimé du sac d’objets ou lorsque le conteneur d’objets est supprimé. Cette fonction est généralement utilisée pour libérer toute mémoire dynamique associée à Item. La fonction doit être prototype comme suit :

void Free (IN PVOID Data);

Si l’appelant ne spécifie pas ce paramètre facultatif, Item est libéré avec ExFreePool lorsqu’il est supprimé du sac d’objets ou lorsque le sac d’objets est supprimé.

Valeur retournée

Retourne STATUS_SUCCESS indiquant que l’ajout s’est déroulé normalement ou STATUS_INSUFFICIENT_RESOURCES indiquant que les ressources système sont insuffisantes pour que l’opération se poursuive.

Remarques

Avant d’appeler KsAddItemToObjectBag, le minidriver doit acquérir le mutex associé au sac d’objets spécifique. Si ObjectBag est membre d’un objet KSDEVICE ou KSFILTERFACTORY, achetez le mutex d’appareil. Si le sac est membre d’un KSFILTER, achetez le mutex du contrôle de filtre. Si le sac est membre d’un objet KSPIN , achetez le mutex du contrôle de filtre KSFILTER parent.

Pour plus d’informations, consultez Sacs d’objets et mutexes dans AVStream.

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