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 |