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

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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 SetTransportBasicParameters método define as propriedades gerais do transporte.

Sintaxe

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

Parâmetros

[in] Param

Especifica qual propriedade definir. Confira Comentários para obter mais informações.

[in] Value

Especifica o valor da propriedade como um inteiro longo . Confira Comentários para obter mais informações.

[in] pszData

Especifica o valor da propriedade como um LPOLESTR. Confira Comentários para obter mais informações.

Retornar valor

Quando esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT . Os códigos de erro possíveis incluem o seguinte.

Comentários

O parâmetro Param é um sinalizador que especifica qual propriedade definir. Para alguns sinalizadores, a propriedade é numérica; use o parâmetro Value para especificar o valor. Para outros sinalizadores, a propriedade é uma cadeia de caracteres; use o parâmetro pszData para especificar o valor. Em ambos os casos, o método ignora o outro parâmetro.

Para os sinalizadores a seguir, o parâmetro Value usa uma constante definida.

• ED_TRANSBASIC_TIME_FORMAT: especifica o formato de hora.

  Constante	Descrição
  ED_FORMAT_MILLISECONDS	Milissegundos.
  ED_FORMAT_FRAMES	Quadros.
  ED_FORMAT_REFERENCE_TIME	Hora da referência.
  ED_FORMAT_HMSF	Decimal codificado binário, representando horas, minutos, segundos e quadros.
  ED_FORMAT_TMSF	Decimal codificado binário, representando faixas, minutos, segundos e quadros.

   
• ED_TRANSBASIC_TIME_REFERENCE: especifica o tempo de referência em uso pelo dispositivo.

  Constante	Descrição
  ED_TIMEREF_TIMECODE	Código de tempo.
  ED_TIMEREF_CONTROL_TRACK	Controle de controle.
  ED_TIMEREF_INDEX	Índice.
  ED_TIMEREF_ATN	Número absoluto da faixa. Essa constante é definida no arquivo de cabeçalho Xprtdefs.h.

   
• ED_TRANSBASIC_END_STOP_ACTION: especifica a ação que o dispositivo executa quando chega ao final do meio de transporte.

  Constante	Descrição
  ED_MODE_STOP	Parar.
  ED_MODE_REWIND	Rebobinar.
  ED_MODE_FREEZE	Congelar/pausar.

   
• ED_TRANSBASIC_RECORD_FORMAT: especifica a velocidade de gravação.

  Constante	Descrição
  ED_RECORD_FORMAT_SP	Jogo padrão.
  ED_RECORD_FORMAT_LP	Jogo longo.
  ED_RECORD_FORMAT_EP	Jogo estendido.

   
• ED_TRANSBASIC_SUPERIMPOSE: especifica se a exibição na tela está habilitada ou desabilitada.

  Constante	Descrição
  OATRUE	A exibição na tela está habilitada.
  OAFALSE	A exibição na tela está desabilitada.

   
• ED_TRANSBASIC_STEP_UNIT: especifica a unidade de etapa.

  Constante	Descrição
  ED_STEP_FIELD	Campos.
  ED_STEP_FRAME	Quadros.
  ED_STEP_3_2	3/2 Pulldown.

   
• ED_TRANSBASIC_SET_COUNTER_FORMAT: define o formato de hora do contador. Consulte o sinalizador ED_TRANSBASIC_TIME_FORMAT para obter valores possíveis.

Para os sinalizadores a seguir, use uma cadeia de caracteres no parâmetro pszData .

Implementação de DV

O MSDV não dá suporte a esse método. Ele retorna E_NOTIMPL.

Requisitos

Confira também

Códigos de erro e êxito

IAMExtTransport Interface

IAMExtTransport::GetTransportBasicParameters