KsFilterFactoryAddCreateItem-Funktion (ks.h)

Die KsFilterFactoryAddCreateItem--Funktion fügt ein neues Erstellungselement für die angegebene Filterfactory hinzu.

Syntax

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

Parameter

[in] FilterFactory

Ein Zeiger auf eine KSFILTERFACTORY Struktur, die die Filterfactory darstellt, der ein neues Erstellungselement hinzugefügt werden soll.

[in] RefString

Ein Zeiger auf eine Unicode-Textzeichenfolge, die das Erstellungselement identifiziert.

[in, optional] SecurityDescriptor

Dieser Parameter enthält optional einen Zeiger auf eine SECURITY_DESCRIPTOR Struktur für diesen Objekttyp. Informationen zu dieser Struktur finden Sie im Microsoft Windows SDK. Verwandte Informationen finden Sie unter KSOBJECT_CREATE_ITEM. Wenn NULL-, wird kein Deskriptor zugewiesen.

[in] CreateItemFlags

Siehe die Tabelle für das Flags Mitglied von KSOBJECT_CREATE_ITEM.

Rückgabewert

KsFilterFactoryAddCreateItem Erfolg oder Fehler des Versuchs, ein neues Erstellungselement hinzuzufügen, zurück.

Bemerkungen

Normalerweise wird nur ein einzelnes Erstellungselement mit der im Filterdeskriptor bereitgestellten Referenz-GUID für die Filterfactory hinzugefügt. Mit dieser Funktion kann der Aufrufer Elemente hinzufügen, die der angegebenen Filterfactory zugeordnet sind.

Weitere Informationen finden Sie unter Initialisieren eines AVStream Minidriver-.

Anforderungen

Siehe auch

KSOBJECT_CREATE_ITEM

KsAddObjectCreateItemToDeviceHeader

KsAddObjectCreateItemToObjectHeader-

KsAllocateObjectCreateItem-

KsFreeObjectCreateItem-

KsQueryObjectCreateItem-