Função MFRegisterLocalByteStreamHandler (mfapi.h)
Registra um manipulador de fluxo de bytes no processo do chamador.
Sintaxe
HRESULT MFRegisterLocalByteStreamHandler(
[in] PCWSTR szFileExtension,
[in] PCWSTR szMimeType,
[in] IMFActivate *pActivate
);
Parâmetros
[in] szFileExtension
Uma cadeia de caracteres que contém a extensão de nome de arquivo para esse manipulador.
[in] szMimeType
Uma cadeia de caracteres que contém o tipo MIME para esse manipulador.
[in] pActivate
Um ponteiro para a interface IMFActivate de um objeto de ativação. O chamador implementa essa interface. O método IMFActivate::ActivateObject do objeto de ativação deve criar um manipulador de fluxo de bytes. O manipulador de fluxo de bytes expõe a interface IMFByteStreamHandler .
Retornar valor
Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Manipuladores de fluxo de bytes são usados no Microsoft Media Foundation durante o processo de resolução de origem, que cria uma fonte de mídia de uma URL. Para obter mais informações, consulte Manipuladores de esquema e manipuladores de Byte-Stream.
Em um processo, os manipuladores de fluxo de bytes locais têm precedência sobre manipuladores de fluxo de bytes registrados no registro. Manipuladores de fluxo de bytes locais não são visíveis para outros processos.
Use essa função se quiser registrar um manipulador de fluxo de bytes personalizado para seu aplicativo, mas não quiser que o manipulador esteja disponível para outros aplicativos.
SzFileExtension ou szMimeType podem ser NULL; pelo menos um deve ser não NULL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | mfapi.h |
| Biblioteca | Mfplat.lib |
| DLL | Mfplat.dll |