Método IAMStreamSelect::Info (strmif.h)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El Info método recupera información sobre una secuencia determinada.
Sintaxis
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 de base cero de la secuencia.
[out] ppmt
Dirección de una variable que recibe un puntero al tipo de medio de la secuencia. Este parámetro es opcional y puede ser NULL. Si el valor no es NULL, el método devuelve un puntero a una estructura AM_MEDIA_TYPE . El autor de la llamada debe eliminar la estructura, incluido el bloque de formato. (Puede usar la función DeleteMediaType desde la biblioteca de clases base directShow).
[out] pdwFlags
Puntero a una variable que recibe uno de los siguientes valores:
| Valor | Descripción |
|---|---|
| Cero | Esta secuencia está deshabilitada. |
| AMSTREAMSELECTINFO_ENABLED | La secuencia está habilitada y otras personas de este grupo también se pueden habilitar. |
| AMSTREAMSELECTINFO_EXCLUSIVE | Esta secuencia es la única secuencia habilitada en el grupo. |
Este parámetro es opcional y puede ser NULL.
[out] plcid
Puntero a una variable que recibe un valor de contexto de configuración regional (LCID). Si la secuencia está asociada a una configuración regional determinada, el LCID se devuelve en esta variable. De lo contrario, la variable recibe el valor cero. Este parámetro es opcional y puede ser NULL.
[out] pdwGroup
Puntero a una variable que recibe el grupo lógico con el que está asociado la secuencia. Este parámetro es opcional y puede ser NULL.
[out] ppszName
Dirección de una variable que recibe un puntero al nombre de la secuencia. El llamador debe liberar la cadena devuelta llamando a la función CoTaskMemFree . Este parámetro es opcional y puede ser NULL.
[out] ppObject
Dirección de una variable que recibe un puntero de interfaz IUnknown . El método puede devolver un puntero a un pin o filtro asociado a la secuencia, o bien podría devolver el valor NULL. Si el método devuelve un valor distinto de NULL , el llamador debe liberar el puntero IUnknown .
Llamar al método IAMStreamSelect::Enable podría invalidar el objeto devuelto por este método.
Este parámetro es opcional y puede ser NULL.
Los filtros de analizador MPEG-1 Stream Splitter, MPEG-2 y SAMI (CC) devuelven un puntero al pin asociado a la secuencia seleccionada.
[out] ppUnk
Dirección de una variable que recibe un puntero de interfaz IUnknown . El método podría devolver un puntero a una interfaz específica de la secuencia, o podría devolver el valor NULL. Si el método devuelve un valor distinto de NULL , el llamador debe liberar el puntero IUnknown . Este parámetro es opcional y puede ser NULL.
El analizador MPEG-1 Stream Splitter, MPEG-2 Splitter y SAMI (CC) devuelven el valor NULL. Los filtros de terceros pueden devolver un puntero a una interfaz de filtro personalizada.
Valor devuelto
Devuelve un valor HRESULT . Estos son algunos de los valores posibles.
| Código devuelto | Descripción |
|---|---|
|
Error. |
|
Memoria insuficiente. |
|
El índice está fuera del intervalo. |
|
Correcto. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluya Dshow.h) |
| Library | Strmiids.lib |