Metodo IMFSourceResolver::BeginCreateObjectFromURL (mfidl.h)

Articolo
08/24/2023

Avvia una richiesta asincrona per creare un'origine multimediale o un flusso di byte da un URL.

Sintassi

HRESULT BeginCreateObjectFromURL(
  [in]  LPCWSTR          pwszURL,
  [in]  DWORD            dwFlags,
  [in]  IPropertyStore   *pProps,
  [out] IUnknown         **ppIUnknownCancelCookie,
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *punkState
);

Parametri

[in] pwszURL

Stringa con terminazione Null contenente l'URL da risolvere.

[in] dwFlags

OR bit per bit dei flag. Vedere Flag del resolver di origine.

[in] pProps

Puntatore all'interfaccia IPropertyStore di un archivio delle proprietà. Il metodo passa l'archivio delle proprietà al gestore dello schema o al gestore del flusso di byte che crea l'oggetto. Il gestore può usare l'archivio delle proprietà per configurare l'oggetto. Questo parametro può essere NULL. Per altre informazioni, vedere Configurazione di un'origine multimediale.

[out] ppIUnknownCancelCookie

Riceve un puntatore IUnknown o il valore NULL. Se il valore non è NULL, è possibile annullare l'operazione asincrona passando questo puntatore al metodo IMFSourceResolver::CancelObjectCreation . Il chiamante deve rilasciare l'interfaccia. Questo parametro può essere NULL.

[in] pCallback

Puntatore all'interfaccia IMFAsyncCallback di un oggetto callback. Il chiamante deve implementare questa interfaccia.

[in] punkState

Puntatore all'interfaccia IUnknown di un oggetto di stato, definito dal chiamante. Questo parametro può essere NULL. È possibile utilizzare questo oggetto per contenere le informazioni sullo stato. L'oggetto viene restituito al chiamante quando viene richiamato il callback.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
MF_E_SOURCERESOLVER_MUTUALLY_EXCLUSIVE_FLAGS	Il parametro dwFlags contiene flag che si escludono a vicenda.
MF_E_UNSUPPORTED_SCHEME	Lo schema URL non è supportato.

Commenti

Il parametro dwFlags deve contenere il flag MF_RESOLUTION_MEDIASOURCE o il flag di MF_RESOLUTION_BYTESTREAM, ma non deve contenere entrambi.

Per i file locali, è possibile passare il nome del file nel parametro pwszURL ; lo file: schema non è obbligatorio.

Al termine dell'operazione, il resolver di origine chiama il metodo IMFAsyncCallback::Invoke . Il metodo Invoke deve chiamare IMFSourceResolver::EndCreateObjectFromURL per ottenere un puntatore all'oggetto creato.

L'utilizzo del parametro pProps dipende dall'implementazione dell'origine multimediale.

Requisiti


Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfidl.h
Libreria	Mfuuid.lib

Vedi anche

IMFSourceResolver

Resolver di origine