Propriedade IWMPControls3::currentPositionTimecode

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, 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.]

A propriedade currentPositionTimecode obtém ou define a posição atual no item de mídia atual usando um formato de código de tempo. Atualmente, essa propriedade dá suporte ao código de tempo SMPTE.

Sintaxe

public System.String currentPositionTimecode {get; set;}

Public Property currentPositionTimecode As System.String

Valor da propriedade

Um System.String que é o código de tempo SMPTE.

Comentários

O código de tempo SMPTE fornece uma maneira padrão de identificar um quadro de vídeo individual, o que é útil para sincronizar a reprodução. Se um arquivo de mídia digital der suporte ao código de tempo SMPTE, Reprodutor Multimídia do Windows poderá recuperar as informações atuais de posição do código de hora ou procurar um quadro de vídeo identificado por um código de tempo específico.

O código de tempo SMPTE identifica um determinado quadro pelo número de horas, minutos, segundos e quadros que o separam de um quadro de referência específico do quadro designado como zero de tempo. Normalmente, o período zero é o início do arquivo e um valor de código de hora SMPTE específico representa o tempo decorrido desde o início do arquivo.

O código de hora está no formato [intervalo]hh:mm:ss. ff em que [intervalo] representa o intervalo, hh representa horas, mm representa minutos, ss representa segundos e ff representa quadros. Ao definir um valor para currentPositionTimecode, você deve incluir todos os oito dígitos, usando zeros como espaços reservados.

[intervalo] corresponde ao membro wRange da estrutura WMT_TIMECODE_EXTENSION_DATA do Formato de Mídia do Windows. Para obter mais informações sobre intervalos de código de tempo, consulte o SDK do Formato de Mídia do Windows.

A configuração e a obtenção de currentPositionTimecode têm suporte apenas para arquivos que contêm informações de código de hora SMPTE.

Exemplos

O exemplo de código a seguir especifica currentPositionTimecode como 1 hora, zero minutos, 30 segundos e 5 quadros. O objeto AxWMPLib.AxWindowsMediaPlayer é representado pela variável chamada player.

// Cast the interface returned by player.Ctlcontrols to an IWMPControls3 interface
// so that you can use the currentPositionTimecode property.
WMPLib.IWMPControls3 controls = (WMPLib.IWMPControls3)player.Ctlcontrols;

// Seek to a frame using SMPTE time code.
controls.currentPositionTimecode = "[00000]01:00:30.05";

' Cast the interface returned by player.Ctlcontrols to an IWMPControls3 interface
' so that you can use the currentPositionTimecode property.
Dim controls As WMPLib.IWMPControls3 = player.Ctlcontrols

' Seek to a frame using SMPTE time code.
Controls.currentPositionTimecode = "[00000]01:00:30.05"

Requisitos

Requisito	Valor
Versão	série Reprodutor Multimídia do Windows 9 ou posterior
Namespace	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Confira também

Interface IWMPControls3 (VB e C#)