Método IAMFilterData::P arseFilterData
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 ParseFilterData método descompacta os dados binários do Registro para um filtro.
Normalmente, não há nenhum motivo para um aplicativo chamar esse método. O método IFilterMapper2::EnumMatchingFilters fornece uma maneira mais conveniente de acessar os dados do registro de filtro.
Sintaxe
HRESULT ParseFilterData(
[in] BYTE *rgbFilterData,
[in] ULONG cb,
[out] BYTE **prgbRegFilter2
);
Parâmetros
-
rgbFilterData [in]
-
Ponteiro para os dados binários do Registro. Você pode obter esses dados recuperando a propriedade "FilterData" do moniker de filtro. Os dados são armazenados como uma SAFEARRAY de bytes (VT_UI1 | VT_ARRAY).
-
cb [in]
-
Especifica o tamanho dos dados binários, em bytes.
-
prgbRegFilter2 [out]
-
Endereço de uma variável que recebe um ponteiro para os dados descompactados. Quando o método retornar, converta esse ponteiro em um tipo REGFILTER2 para acessar os dados do filtro. O chamador deve liberar a memória chamando o método CoTaskMemFree .
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 Exemplo de Mapeador no SDK do Windows.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| DLL |
|
Confira também