Função MFRegisterLocalSchemeHandler (mfapi.h)

Registra um manipulador de esquema no processo do chamador.

Sintaxe

HRESULT MFRegisterLocalSchemeHandler(
  [in] PCWSTR      szScheme,
  [in] IMFActivate *pActivate
);

Parâmetros

[in] szScheme

Uma cadeia de caracteres que contém o esquema. O esquema inclui o caractere ':' à direita; por exemplo, "http:".

[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 objeto de manipulador de esquema. O manipulador de esquema expõe a interface IMFSchemeHandler .

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 esquema são usados no Microsoft Media Foundation durante o processo de resolução do código-fonte, que cria uma fonte de mídia de uma URL. Para obter mais informações, consulte Manipuladores de esquema e manipuladores de Byte-Stream.

Dentro de um processo, os manipuladores de esquema local têm precedência sobre manipuladores de esquema registrados no registro. Manipuladores de esquema local não são visíveis para outros processos.

Use essa função se quiser registrar um manipulador de esquema personalizado para seu aplicativo, mas não quiser que o manipulador esteja disponível para outros aplicativos.

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

MFRegisterLocalByteStreamHandler

Funções do Media Foundation

Manipuladores de esquema e manipuladores de Byte-Stream