Método IAMFilterData::CreateFilterData
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
Observação
Essa interface foi substituída. Novos aplicativos não devem usá-lo.
O CreateFilterData método cria dados binários do Registro para um filtro. Esses dados podem ser gravados no registro como uma subchave REG_BINARY chamada FilterData, sob a chave CLSID do filtro.
Normalmente, não há nenhum motivo para um aplicativo chamar esse método. O método IFilterMapper2::RegisterFilter cria automaticamente os dados binários e os adiciona ao local correto no Registro. Para obter mais informações, confira Como registrar filtros do DirectShow.
Sintaxe
HRESULT CreateFilterData(
[in] REGFILTER2 *prf2,
[out] BYTE **prgbFilterData,
[out] ULONG *pcb
);
Parâmetros
-
prf2 [in]
-
Ponteiro para uma estrutura REGFILTER2 que contém as informações de filtro.
-
prgbFilterData [out]
-
Endereço de uma variável que recebe um ponteiro para os dados binários. O método aloca a memória para os dados. O chamador deve liberar a memória chamando o método CoTaskMemFree .
-
pcb [out]
-
Ponteiro para uma variável que recebe o tamanho dos dados binários, em bytes.
Retornar valor
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Comentários
Observação
O cabeçalho Fil_data.h está localizado no diretório Mapper Sample no SDK do Windows.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| DLL |
|
Confira também