Funzione KsFilterFactoryAddCreateItem (ks.h)
La funzione KsFilterFactoryAddCreateItem aggiunge un nuovo elemento di creazione per la factory di filtro specificata.
Sintassi
KSDDKAPI NTSTATUS KsFilterFactoryAddCreateItem(
[in] PKSFILTERFACTORY FilterFactory,
[in] PWSTR RefString,
[in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor,
[in] ULONG CreateItemFlags
);
Parametri
[in] FilterFactory
Puntatore a una struttura KSFILTERFACTORY che rappresenta la factory di filtro a cui aggiungere un nuovo elemento di creazione.
[in] RefString
Puntatore a una stringa di testo Unicode che identifica l'elemento di creazione.
[in, optional] SecurityDescriptor
Questo parametro contiene facoltativamente un puntatore a una struttura SECURITY_DESCRIPTOR per questo tipo di oggetto. Vedere la Microsoft Windows SDK Per informazioni su questa struttura. Per informazioni correlate, vedere KSOBJECT_CREATE_ITEM. Se NULL non viene assegnato alcun descrittore.
[in] CreateItemFlags
Vedere la tabella per il membro Flags di KSOBJECT_CREATE_ITEM.
Valore restituito
KsFilterFactoryAddCreateItem restituisce esito positivo o negativo del tentativo di aggiungere un nuovo elemento di creazione.
Commenti
In genere, viene aggiunto solo un singolo elemento di creazione usando il GUID di riferimento fornito nel descrittore di filtro. Questa funzione consente al chiamante di aggiungere elementi di creazione associati alla data filter factory.
Per altre informazioni, vedere Inizializzazione di un minidriver AVStream.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile in Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX. |
Piattaforma di destinazione | Universale |
Intestazione | ks.h (include Ks.h) |
Libreria | Ks.lib |
Vedi anche
KsAddObjectCreateItemToDeviceHeader