IPropertySetter::AddProp-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die AddProp -Methode fügt dem Eigenschaftensetter eine Eigenschaft hinzu, wobei ein Array von Zeit-Wert-Paaren den Wert der Eigenschaft über einen bestimmten Zeitraum definiert.

Syntax

HRESULT AddProp(
  [in] DEXTER_PARAM Param,
  [in] DEXTER_VALUE *paValue
);

Parameter

Param [in]

DEXTER_PARAM Struktur, die die -Eigenschaft angibt. Das nValues-Element der -Struktur muss der Größe des Arrays entsprechen, das im paValue-Parameter angegeben ist.

paValue [in]

Zeiger auf ein Array von DEXTER_VALUE Strukturen, die Zeit-Wert-Paare enthalten. Das Array muss sich in aufsteigender Zeitreihenfolge befinden. Die Zeiten sind relativ zur Startzeit des Effekts oder Übergangs.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Bemerkungen

Die erste DEXTER_VALUE-Struktur muss eine Referenzzeit von null und ein Interpolationsflag (dwInterp) von DEXTERF_JUMP angeben, oder die Methode gibt einen Fehler zurück.

Anforderungen

Siehe auch

IPropertySetter-Schnittstelle

Fehler- und Erfolgscodes