Método IAMExtTransport::GetTransportBasicParameters (strmif.h)

  • Artículo

[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 GetTransportBasicParameters método recupera las propiedades generales del transporte externo.

Sintaxis

HRESULT GetTransportBasicParameters(
  [in]      long     Param,
  [in, out] long     *pValue,
  [in, out] LPOLESTR *ppszData
);

Parámetros

[in] Param

Especifica la propiedad que se va a recibir.

[in, out] pValue

Puntero a una variable que recibe un valor entero largo . Vea Comentarios para obtener más información.

[in, out] ppszData

Puntero a una variable de tipo LPOLESTR que recibe una cadena. Vea Comentarios para obtener más información.

Valor devuelto

Cuando este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

El parámetro Param es una marca que especifica qué propiedad se va a recuperar. Algunas propiedades son numéricas; se devuelven en el parámetro pValue . Otras propiedades son valores de cadena; se devuelven en el parámetro ppszData . Para obtener una lista de marcas y valores esperados, vea IAMExtTransport::SetTransportBasicParameters.

Si el método devuelve una cadena, el autor de la llamada debe liberar la cadena mediante la función CoTaskMemFree .

Implementación de videocámara DV y MPEG

MSDV admite las siguientes marcas adicionales:

  • ED_RAW_EXT_DEV_CMD: invoca un comando AV/C sin formato. Especifique el comando AV/C como una matriz de bytes en el parámetro ppszData . Especifique el tamaño del comando, en bytes, en el parámetro pValue . Cuando el método devuelve, ppszData contiene la respuesta del dispositivo y pValue contiene el tamaño de la respuesta, en bytes. El comando AV/C se pasa directamente al dispositivo sin validación ni comprobación de errores.

    La carga de respuesta puede ser mayor que el comando . Es responsabilidad del autor de la llamada asignar suficiente espacio en el búfer para la respuesta. El tamaño máximo de carga es de 512 bytes.

    Para obtener más información, consulte Emisión de comandos AV/C sin formato.

  • ED_TRANSBASIC_INPUT_SIGNAL: recupera el formato de señal que la videocámara DV está diseñada para aceptar. Devuelve una de las siguientes constantes en pValue.
    Constante Descripción
    ED_TRANSBASIC_SIGNAL_525_60_SD Señal SD NTSC.
    ED_TRANSBASIC_SIGNAL_525_60_SDL Señal de NTSC SDL (long-play).
    ED_TRANSBASIC_SIGNAL_625_50_SD Señal PAL SD.
    ED_TRANSBASIC_SIGNAL_625_50_SDL Señal pal SDL (long-play).
    ED_TRANSBASIC_SIGNAL_MPEG2TS Señal D-VHS.
     
  • ED_TRANSBASIC_OUTPUT_SIGNAL: recupera el formato de señal que la videocámara DV está diseñada para transmitir. Devuelve una de las constantes enumeradas para la marca ED_TRANSBASIC_INPUT_SIGNAL.

MSTape admite valores adicionales para ED_TRANSBASIC_INPUT_SIGNAL y ED_TRANSBASIC_OUTPUT_SIGNAL.

Constante Descripción
ED_TRANSBASIC_SIGNAL_2500_60_MPEG Secuencia MPEG de 25 Mbps/60.
ED_TRANSBASIC_SIGNAL_1250_60_MPEG Secuencia MPEG de 12,5 Mbps/60.
ED_TRANSBASIC_SIGNAL_0625_60_MPEG Secuencia MPEG de 6,25 Mbps/60.
ED_TRANSBASIC_SIGNAL_2500_50_MPEG Secuencia MPEG de 25 Mbps/50.
ED_TRANSBASIC_SIGNAL_1250_50_MPEG Secuencia MPEG de 12,5 Mbps/50.
ED_TRANSBASIC_SIGNAL_0625_50_MPEG Secuencia MPEG de 6,25 Mbps/50.
ED_TRANSBASIC_SIGNAL_UNKNOWN Formato de señal desconocido.
 

Estas marcas se definen en el archivo de encabezado Xprtdefs.h.

En Windows XP Service Pack 2 y versiones posteriores, se definen los siguientes tipos de señal adicionales para las marcas ED_TRANSBASIC_INPUT_SIGNAL y ED_TRANSBASIC_OUTPUT_SIGNAL.

Constante Descripción
ED_TRANSBASIC_SIGNAL_525_60_DV25 DVCPRO 25, 525-60.
ED_TRANSBASIC_SIGNAL_625_50_DV25 DVCPRO 25, 625-50.
ED_TRANSBASIC_SIGNAL_525_60_DV50 DVCPRO 50, 525-60.
ED_TRANSBASIC_SIGNAL_625_50_DV50 DVCPRO 50, 625-50.
ED_TRANSBASIC_SIGNAL_HD_60_DVH1 DVCPRO 100, 1080i o 720p
ED_TRANSBASIC_SIGNAL_HD_50_DVH1 DVCPRO 100, solo 1080i
 

Para usar estas constantes, incluya el archivo de encabezado Xprtdefs.h del Windows SDK.

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

Consulte también

Códigos de error y éxito

IAMExtTransport (interfaz)