KsFilterFactoryAddCreateItem-Funktion (ks.h)
Die KsFilterFactoryAddCreateItem-Funktion fügt ein neues Create-Element für die angegebene Filter factory 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 Filter factory darstellt, der ein neues Erstellungselement hinzugefügt werden soll.
[in] RefString
Ein Zeiger auf eine Unicode-Textzeichenfolge, die das Create-Element identifiziert.
[in, optional] SecurityDescriptor
Dieser Parameter enthält optional einen Zeiger auf eine SECURITY_DESCRIPTOR Struktur für diesen Objekttyp. Weitere Informationen zu dieser Struktur finden Sie im Microsoft Windows SDK. Weitere Informationen finden Sie unter KSOBJECT_CREATE_ITEM. Wenn NULL, wird kein Deskriptor zugewiesen.
[in] CreateItemFlags
Sehen Sie sich die Tabelle für das Flags-Element von KSOBJECT_CREATE_ITEM an.
Rückgabewert
KsFilterFactoryAddCreateItem gibt einen Erfolgreichen oder Fehler beim Versuch zurück, ein neues Erstellungselement hinzuzufügen.
Hinweise
Normalerweise wird nur ein einzelnes Erstellungselement mit der im Filterdeskriptor angegebenen Verweis-GUID für die Filterfactory hinzugefügt. Mit dieser Funktion kann der Aufrufer Erstellungselemente hinzufügen, die der angegebenen Filterfactory zugeordnet sind.
Weitere Informationen finden Sie unter Initializing an AVStream Minidriver.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| Bibliothek | Ks.lib |
Weitere Informationen
KsAddObjectCreateItemToDeviceHeader