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 do Flags do KSOBJECT_CREATE_ITEM.
Valor de retorno
KsFilterFactoryAddCreateItem retorna êxito ou falha da tentativa de adicionar um novo item de criação.
Observações
Normalmente, somente 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 |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |
Consulte também
KsAddObjectCreateItemToDeviceHeader