Funzione KsFilterFactoryAddCreateItem (ks.h)

Articolo
02/07/2025

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. Per informazioni su questa struttura, vedere Microsoft Windows SDK. Per informazioni correlate, vedere KSOBJECT_CREATE_ITEM. Se null, non viene assegnato alcun descrittore.

[in] CreateItemFlags

Vedere la tabella relativa al membro flag di di KSOBJECT_CREATE_ITEM.

Valore restituito

KsFilterFactoryAddCreateItem restituisce esito positivo o negativo del tentativo di aggiungere un nuovo elemento di creazione.

Osservazioni

In genere, viene aggiunto solo un singolo elemento di creazione usando il GUID di riferimento fornito nel descrittore di filtro per la factory di filtro. Questa funzione consente al chiamante di aggiungere elementi di creazione associati alla factory di filtro specificata.

Per altre informazioni, vedere Inizializzazione di un minidriver AVStream.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in DirectX 8.0 e versioni successive di DirectX.
piattaforma di destinazione	Universale
intestazione	ks.h (include Ks.h)
libreria	Ks.lib