KsFilterFactoryAddCreateItem, fonction (ks.h)
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 nouvel é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. Consultez la Microsoft Windows SDK pour plus d’informations sur cette structure. Pour plus d’informations, consultez KSOBJECT_CREATE_ITEM. Si la valeur est NULL, aucun descripteur n’est affecté.
[in] CreateItemFlags
Consultez le tableau du membre Flags de KSOBJECT_CREATE_ITEM.
Valeur retournée
KsFilterFactoryAddCreateItem retourne la réussite ou l’échec de la tentative d’ajout d’un nouvel é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 filtre. 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.
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 |
Voir aussi
KsAddObjectCreateItemToDeviceHeader