Método IAMStreamSelect::Info (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O Info método recupera informações sobre um determinado fluxo.

Sintaxe

HRESULT Info(
  [in]  long          lIndex,
  [out] AM_MEDIA_TYPE **ppmt,
  [out] DWORD         *pdwFlags,
  [out] LCID          *plcid,
  [out] DWORD         *pdwGroup,
  [out] LPWSTR        *ppszName,
  [out] IUnknown      **ppObject,
  [out] IUnknown      **ppUnk
);

Parâmetros

[in] lIndex

Índice baseado em zero do fluxo.

[out] ppmt

Endereço de uma variável que recebe um ponteiro para o tipo de mídia do fluxo. Esse parâmetro é opcional e pode ser NULL. Se o valor não for NULL, o método retornará um ponteiro para uma estrutura AM_MEDIA_TYPE . O chamador deve excluir a estrutura, incluindo o bloco de formato. (Você pode usar a função DeleteMediaType da biblioteca de classe base do DirectShow.)

[out] pdwFlags

Ponteiro para uma variável que recebe um dos seguintes valores:

Esse parâmetro é opcional e pode ser NULL.

[out] plcid

Ponteiro para uma variável que recebe um valor LCID (contexto de localidade). Se o fluxo estiver associado a uma localidade específica, o LCID será retornado nessa variável. Caso contrário, a variável receberá o valor zero. Esse parâmetro é opcional e pode ser NULL.

[out] pdwGroup

Ponteiro para uma variável que recebe o grupo lógico ao qual o fluxo está associado. Esse parâmetro é opcional e pode ser NULL.

[out] ppszName

Endereço de uma variável que recebe um ponteiro para o nome do fluxo. O chamador deve liberar a cadeia de caracteres retornada chamando a função CoTaskMemFree . Esse parâmetro é opcional e pode ser NULL.

[out] ppObject

Endereço de uma variável que recebe um ponteiro de interface IUnknown . O método pode retornar um ponteiro para um pino ou filtro associado ao fluxo ou pode retornar o valor NULL. Se o método retornar um valor não NULL , o chamador deverá liberar o ponteiro IUnknown .

Chamar o método IAMStreamSelect::Enable pode invalidar o objeto retornado por esse método.

Esse parâmetro é opcional e pode ser NULL.

Os filtros de analisador MPEG-1 Stream Splitter, MPEG-2 e SAMI (CC) retornam um ponteiro para o pino associado ao fluxo selecionado.

[out] ppUnk

Endereço de uma variável que recebe um ponteiro de interface IUnknown . O método pode retornar um ponteiro para uma interface específica para o fluxo ou pode retornar o valor NULL. Se o método retornar um valor não NULL , o chamador deverá liberar o ponteiro IUnknown . Esse parâmetro é opcional e pode ser NULL.

Os filtros de analisador MPEG-1 Stream Splitter, MPEG-2 e SAMI (CC) retornam o valor NULL. Filtros de terceiros podem retornar um ponteiro para uma interface de filtro personalizada.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Requisitos

Confira também

Códigos de erro e êxito

IAMStreamSelect Interface