KsFilterFactoryAddCreateItem, fonction (ks.h)

Article
02/07/2025

La fonction KsFilterFactoryAddCreateItem ajoute un nouvel élément de création pour la fabrique de filtre spécifiée.

Syntaxe

KSDDKAPI NTSTATUS KsFilterFactoryAddCreateItem(
  [in]           PKSFILTERFACTORY     FilterFactory,
  [in]           PWSTR                RefString,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in]           ULONG                CreateItemFlags
);

Paramètres

[in] FilterFactory

Pointeur vers une structure KSFILTERFACTORY représentant la fabrique de filtre à laquelle ajouter un élément de création.

[in] RefString

Pointeur vers une chaîne de texte Unicode qui identifie l’élément de création.

[in, optional] SecurityDescriptor

Ce paramètre contient éventuellement un pointeur vers une structure SECURITY_DESCRIPTOR pour ce type d’objet. Pour plus d’informations sur cette structure, consultez le Kit de développement logiciel (SDK) Microsoft Windows. Pour plus d’informations, consultez KSOBJECT_CREATE_ITEM. Si NULL, aucun descripteur n’est affecté.

[in] CreateItemFlags

Consultez le tableau des indicateurs de membre de KSOBJECT_CREATE_ITEM.

Valeur de retour

KsFilterFactoryAddCreateItem retourne la réussite ou l’échec de la tentative d’ajout d’un élément de création.

Remarques

Normalement, un seul élément de création à l’aide du GUID de référence fourni dans le descripteur de filtre est ajouté pour la fabrique de filtres. Cette fonction permet à l’appelant d’ajouter des éléments de création associés à la fabrique de filtre donnée.

Pour plus d’informations, consultez Initialisation d’un minidriver AVStream.

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