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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen. |
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |
Siehe auch
KsAddObjectCreateItemToDeviceHeader