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
Fil_data.h
DLL
Quartz.dll

Confira também

IAMFilterData Interface