Método IAMExtTransport::SetTransportBasicParameters (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 SetTransportBasicParameters método establece las propiedades generales del transporte.

Sintaxis

HRESULT SetTransportBasicParameters(
  [in] long      Param,
  [in] long      Value,
  [in] LPCOLESTR pszData
);

Parámetros

[in] Param

Especifica la propiedad que se va a establecer. Vea Comentarios para obtener más información.

[in] Value

Especifica el valor de la propiedad como un entero largo . Vea Comentarios para obtener más información.

[in] pszData

Especifica el valor de la propiedad como LPOLESTR. 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 . Entre los posibles códigos de error se incluyen los siguientes.

Código devuelto Descripción
E_NOTIMPL
 El dispositivo no admite la configuración de esta propiedad.
ERROR_DEVICE_REMOVED
 Se quitó el dispositivo.

Comentarios

El parámetro Param es una marca que especifica la propiedad que se va a establecer. Para algunas marcas, la propiedad es numérica; use el parámetro Value para especificar el valor. Para otras marcas, la propiedad es una cadena; use el parámetro pszData para especificar el valor. En cualquier caso, el método omite el otro parámetro.

Para las marcas siguientes, el parámetro Value toma una constante definida.

  • ED_TRANSBASIC_TIME_FORMAT: especifica el formato de hora.
    Constante Descripción
    ED_FORMAT_MILLISECONDS Milisegundos.
    ED_FORMAT_FRAMES Marcos.
    ED_FORMAT_REFERENCE_TIME Hora de referencia.
    ED_FORMAT_HMSF Decimal codificado binario, que representa horas, minutos, segundos y fotogramas.
    ED_FORMAT_TMSF Decimal codificado binario, que representa pistas, minutos, segundos y fotogramas.
     
  • ED_TRANSBASIC_TIME_REFERENCE: especifica la hora de referencia que usa el dispositivo.
    Constante Descripción
    ED_TIMEREF_TIMECODE Código de hora.
    ED_TIMEREF_CONTROL_TRACK Pista de control.
    ED_TIMEREF_INDEX Index:
    ED_TIMEREF_ATN Número de pista absoluto. Esta constante se define en el archivo de encabezado Xprtdefs.h.
     
  • ED_TRANSBASIC_END_STOP_ACTION: especifica la acción que realiza el dispositivo cuando llega al final del medio de transporte.
    Constante Descripción
    ED_MODE_STOP Detener.
    ED_MODE_REWIND Rebobinado.
    ED_MODE_FREEZE Inmovilizar o pausar.
     
  • ED_TRANSBASIC_RECORD_FORMAT: especifica la velocidad de grabación.
    Constante Descripción
    ED_RECORD_FORMAT_SP Juego estándar.
    ED_RECORD_FORMAT_LP Juego largo.
    ED_RECORD_FORMAT_EP Juego extendido.
     
  • ED_TRANSBASIC_SUPERIMPOSE: especifica si la pantalla en pantalla está habilitada o deshabilitada.
    Constante Descripción
    OATRUE La pantalla en pantalla está habilitada.
    OAFALSE La pantalla en pantalla está deshabilitada.
     
  • ED_TRANSBASIC_STEP_UNIT: especifica la unidad de paso.
    Constante Descripción
    ED_STEP_FIELD Campos.
    ED_STEP_FRAME Marcos.
    ED_STEP_3_2 3/2 Pulldown.
     
  • ED_TRANSBASIC_SET_COUNTER_FORMAT: establece el formato de hora del contador. Consulte la marca ED_TRANSBASIC_TIME_FORMAT para ver los valores posibles.
Para las marcas siguientes, use un valor numérico en el parámetro Value .
Marca Descripción
ED_TRANSBASIC_STEP_COUNT Especifica el recuento de pasos, en unidades definidas por la marca ED_TRANSBASIC_STEP_UNIT.
ED_TRANSBASIC_SET_FREEZE_TIMEOUT Especifica el tiempo de espera para el modo de inmovilización, en unidades del formato de hora actual.
ED_TRANSBASIC_SETCLOCK Establece la hora del reloj.
ED_TRANSBASIC_SET_COUNTER_VALUE Establece el valor del contador.
 

Para las marcas siguientes, use una cadena en el parámetro pszData .

Marca Descripción
ED_TRANSBASIC_VOLUME_NAME Especifica el nombre del volumen.
 

Implementación de DV

MSDV no admite este método. Devuelve E_NOTIMPL.

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)

IAMExtTransport::GetTransportBasicParameters