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

Confira também

Funções do Media Foundation

Manipuladores de esquema e manipuladores de Byte-Stream