Função MFCreateStreamDescriptor (mfidl.h)

Cria um descritor de fluxo.

Sintaxe

HRESULT MFCreateStreamDescriptor(
  DWORD               dwStreamIdentifier,
  DWORD               cMediaTypes,
  IMFMediaType        **apMediaTypes,
  IMFStreamDescriptor **ppDescriptor
);

Parâmetros

dwStreamIdentifier

Stream identificador.

cMediaTypes

Número de elementos na matriz apMediaTypes .

apMediaTypes

Ponteiro para uma matriz de ponteiros de interface IMFMediaType . Esses ponteiros são usados para inicializar o manipulador de tipo de mídia para o descritor de fluxo.

ppDescriptor

Recebe um ponteiro para a interface IMFStreamDescriptor do novo descritor de fluxo. O chamador deve liberar a interface .

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

Se você estiver escrevendo uma fonte de mídia personalizada, poderá usar essa função para criar descritores de fluxo para a origem. Essa função cria automaticamente o manipulador de tipo de mídia do descritor de fluxo e o inicializa com a lista de tipos fornecidos em apMediaTypes. No entanto, a função não define o tipo de mídia atual no manipulador. Para definir o tipo, chame IMFMediaTypeHandler::SetCurrentMediaType.

Essa função estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

• Windows XP com Service Pack 2 (SP2) e posterior.
• Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

Confira também

Funções do Media Foundation

Descritores de apresentação