Função KsFilterFactoryAddCreateItem (ks.h)
A função KsFilterFactoryAddCreateItem adiciona um novo item de criação para a fábrica de filtros especificada.
Sintaxe
KSDDKAPI NTSTATUS KsFilterFactoryAddCreateItem(
[in] PKSFILTERFACTORY FilterFactory,
[in] PWSTR RefString,
[in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor,
[in] ULONG CreateItemFlags
);
Parâmetros
[in] FilterFactory
Um ponteiro para uma estrutura KSFILTERFACTORY que representa a fábrica de filtros à qual adicionar um novo item de criação.
[in] RefString
Um ponteiro para uma cadeia de caracteres de texto Unicode que identifica o item de criação.
[in, optional] SecurityDescriptor
Opcionalmente, esse parâmetro contém um ponteiro para uma estrutura de SECURITY_DESCRIPTOR para esse tipo de objeto. Consulte o SDK do Microsoft Windows Para obter informações sobre essa estrutura. Para obter informações relacionadas, consulte KSOBJECT_CREATE_ITEM. Se NULL, nenhum descritor será atribuído.
[in] CreateItemFlags
Consulte a tabela para o membro Flags do KSOBJECT_CREATE_ITEM.
Retornar valor
KsFilterFactoryAddCreateItem retorna êxito ou falha na tentativa de adicionar um novo item de criação.
Comentários
Normalmente, apenas um único item de criação usando o GUID de referência fornecido no descritor de filtro é adicionado para a fábrica de filtros. Essa função permite que o chamador adicione itens de criação associados à fábrica de filtros fornecida.
Para obter mais informações, consulte Inicializando um minidriver AVStream.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| Biblioteca | Ks.lib |
Confira também
KsAddObjectCreateItemToDeviceHeader