Método IPropertySetter::CloneProps

[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.

Nota:

[Desusado. Esta API se puede quitar de futuras versiones de Windows.]

 

El CloneProps método clona un conjunto de propiedades de este establecedor de propiedades y los agrega a un nuevo establecedor de propiedades.

Sintaxis

HRESULT CloneProps(
  [out] IPropertySetter **ppSetter,
  [in]  REFERENCE_TIME  rtStart,
  [in]  REFERENCE_TIME  rtStop
);

Parámetros

ppSetter [out]

Recibe un puntero a la interfaz IPropertySetter del nuevo establecedor de propiedades.

rtStart [in]

Hora de inicio del intervalo de valores que se van a clonar, en unidades de 100 nanosegundos.

rtStop [in]

Reservado.

Valor devuelto

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

Observaciones

Solo se clonan los valores que se encuentran después de la hora de inicio especificada. Las horas de los valores clonados se ajustan en relación con la hora de inicio. Por ejemplo, si rtStart es 200000000 (2 segundos), se clona un valor en el momento 30000000 (3 segundos) con el tiempo 10000000 (1 segundo). Por último, a cada propiedad clonada se le asigna un valor inicial igual al valor de la propiedad original en la hora de inicio (interpolado correctamente si es necesario). En efecto, los datos de propiedad se dividen en la hora de inicio especificada.

Si el método se realiza correctamente, la interfaz IPropertySetter que devuelve tiene un recuento de referencias pendiente. Asegúrese de liberar la interfaz cuando haya terminado de usarla.

Nota:

El archivo de encabezado Qedit.h no es compatible con los encabezados de Direct3D posteriores a la versión 7.

 

Nota:

Para obtener Qedit.h, descargue la actualización de Microsoft Windows SDK para Windows Vista y .NET Framework 3.0. Qedit.h no está disponible en el Microsoft Windows SDK para Windows 7 y .NET Framework 3.5 Service Pack 1.

 

Requisitos

Requisito	Value
Encabezado	Qedit.h
Biblioteca	Strmiids.lib

Consulte también

IPropertySetter (interfaz)

Códigos de error y éxito