Método IMFSourceResolver::BeginCreateObjectFromURL (mfidl.h)

Comienza una solicitud asincrónica para crear un origen multimedia o una secuencia de bytes a partir de una dirección URL.

Sintaxis

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

Parámetros

[in] pwszURL

Cadena terminada en NULL que contiene la dirección URL que se va a resolver.

[in] dwFlags

OR bit a bit de marcas. Consulte Marcas de resolución de origen.

[in] pProps

Puntero a la interfaz IPropertyStore de un almacén de propiedades. El método pasa el almacén de propiedades al controlador de esquema o al controlador de secuencia de bytes que crea el objeto . El controlador puede usar el almacén de propiedades para configurar el objeto. Este parámetro puede ser NULL. Para obtener más información, vea Configuración de un origen multimedia.

[out] ppIUnknownCancelCookie

Recibe un puntero IUnknown o el valor NULL. Si el valor no es NULL, puede cancelar la operación asincrónica pasando este puntero al método IMFSourceResolver::CancelObjectCreation . El autor de la llamada debe liberar la interfaz . Este parámetro puede ser NULL.

[in] pCallback

Puntero a la interfaz IMFAsyncCallback de un objeto de devolución de llamada. El autor de la llamada debe implementar esta interfaz.

[in] punkState

Puntero a la interfaz IUnknown de un objeto de estado, definido por el autor de la llamada. Este parámetro puede ser NULL. Puede usar este objeto para contener información de estado. El objeto se devuelve al autor de la llamada cuando se invoca la devolución de llamada.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
MF_E_SOURCERESOLVER_MUTUALLY_EXCLUSIVE_FLAGS	El parámetro dwFlags contiene marcas mutuamente excluyentes.
MF_E_UNSUPPORTED_SCHEME	No se admite el esquema de dirección URL.

Comentarios

El parámetro dwFlags debe contener la marca MF_RESOLUTION_MEDIASOURCE o la marca MF_RESOLUTION_BYTESTREAM, pero no debe contener ambos.

En el caso de los archivos locales, puede pasar el nombre de archivo en el parámetro pwszURL ; el file: esquema no es necesario.

Cuando se complete la operación, el solucionador de origen llama al método IMFAsyncCallback::Invoke . El método Invoke debe llamar a IMFSourceResolver::EndCreateObjectFromURL para obtener un puntero al objeto que se creó.

El uso del parámetro pProps depende de la implementación del origen multimedia.

Requisitos

Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	mfidl.h
Library	Mfuuid.lib

Consulte también

IMFSourceResolver

Resolución de origen