Condividi tramite


Funzione MFRegisterLocalByteStreamHandler (mfapi.h)

Registra un gestore del flusso di byte nel processo del chiamante.

Sintassi

HRESULT MFRegisterLocalByteStreamHandler(
  [in] PCWSTR      szFileExtension,
  [in] PCWSTR      szMimeType,
  [in] IMFActivate *pActivate
);

Parametri

[in] szFileExtension

Stringa contenente l'estensione del nome file per questo gestore.

[in] szMimeType

Stringa contenente il tipo MIME per questo gestore.

[in] pActivate

Puntatore all'interfaccia IMFActivate di un oggetto attivazione. Il chiamante implementa questa interfaccia. Il metodo IMFActivate::ActivateObject dell'oggetto attivazione deve creare un gestore del flusso di byte. Il gestore del flusso di byte espone l'interfaccia IMFByteStreamHandler .

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

I gestori di flusso di byte vengono usati in Microsoft Media Foundation durante il processo di risoluzione di origine, che crea un'origine multimediale da un URL. Per altre informazioni, vedere Gestori di schemi e gestori Byte-Stream.

All'interno di un processo, i gestori di flusso di byte locali hanno la precedenza sui gestori del flusso di byte registrati nel Registro di sistema. I gestori di flusso di byte locali non sono visibili ad altri processi.

Usare questa funzione se si vuole registrare un gestore di flusso di byte personalizzato per l'applicazione, ma non si vuole che il gestore sia disponibile per altre applicazioni.

SzFileExtension o szMimeType può essere NULL; almeno uno deve essere diverso da NULL.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mfapi.h
Libreria Mfplat.lib
DLL Mfplat.dll

Vedi anche

Funzioni di Media Foundation

Gestori di schemi e gestori di Byte-Stream