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

Inicia uma solicitação assíncrona para criar uma fonte de mídia de um fluxo de bytes.

Sintaxe

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

Parâmetros

[in] pByteStream

Um ponteiro para a interface IMFByteStream do fluxo de bytes.

[in] pwszURL

Uma cadeia de caracteres terminada em nulo que contém a URL original do fluxo de bytes. Este parâmetro pode ser NULL.

[in] dwFlags

Um OR bit a bit de um ou mais sinalizadores. Consulte Sinalizadores de resolvedor de origem.

[in] pProps

Um ponteiro para a interface IPropertyStore de um repositório de propriedades. O método passa o repositório de propriedades para o manipulador de fluxo de bytes. O manipulador de fluxo de bytes pode usar o repositório de propriedades para configurar a origem da mídia. Este parâmetro pode ser NULL. Para obter mais informações, consulte Configurando uma fonte de mídia.

[out] ppIUnknownCancelCookie

Recebe um ponteiro IUnknown ou o valor NULL. Se o valor não for NULL, você poderá cancelar a operação assíncrona passando esse ponteiro para o método IMFSourceResolver::CancelObjectCreation . O chamador deve liberar a interface . Este parâmetro pode ser NULL.

[in] pCallback

Um ponteiro para a interface IMFAsyncCallback de um objeto de retorno de chamada. O chamador deve implementar essa interface.

[in] punkState

Um ponteiro para a interface IUnknown de um objeto de estado, definido pelo chamador. Este parâmetro pode ser NULL. Você pode usar esse objeto para armazenar informações de estado. O objeto é retornado ao chamador quando o retorno de chamada é invocado.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
MF_E_SOURCERESOLVER_MUTUALLY_EXCLUSIVE_FLAGS
O parâmetro dwFlags contém sinalizadores mutuamente exclusivos.
MF_E_UNSUPPORTED_BYTESTREAM_TYPE
Não há suporte para o fluxo de bytes.
MF_E_BYTESTREAM_NOT_SEEKABLE
O fluxo de bytes não dá suporte à busca.

Comentários

O parâmetro dwFlags deve conter o sinalizador MF_RESOLUTION_MEDIASOURCE e não deve conter o sinalizador MF_RESOLUTION_BYTESTREAM .

O resolvedor de origem tenta localizar um ou mais manipuladores de fluxo de bytes para o fluxo de bytes, com base na extensão de nome de arquivo da URL ou no tipo MIME do fluxo de bytes (ou ambos). A URL é especificada no parâmetro pwszURL opcional e o tipo MIME pode ser especificado no atributo MF_BYTESTREAM_CONTENT_TYPE no fluxo de bytes. Manipuladores de fluxo de bytes são registrados por extensão de nome de arquivo ou tipo MIME, ou ambos, conforme descrito em Manipuladores de Esquema e manipuladores de Byte-Stream. O chamador deve especificar pelo menos um desses valores.

Quando a operação for concluída, o resolvedor de origem chamará o método IMFAsyncCallback::Invoke . O método Invoke deve chamar IMFSourceResolver::EndCreateObjectFromByteStream para obter um ponteiro para a fonte de mídia.

Requisitos

   
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mfuuid.lib

Confira também

IMFSourceResolver

Resolvedor de Origem