Metodo IMediaSample2::SetProperties (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo SetProperties imposta le proprietà di un esempio multimediale.

Sintassi

HRESULT SetProperties(
  [in] DWORD      cbProperties,
  [in] const BYTE *pbProperties
);

Parametri

[in] cbProperties

Lunghezza dei dati delle proprietà da impostare, in byte.

[in] pbProperties

Puntatore a un buffer di dimensioni cbProperties.

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito Descrizione
S_OK
 Operazione completata.
E_INVALIDARG
 Argomento non valido.
E_OUTOFMEMORY
 Memoria insufficiente.
E_POINTER
 Argomento puntatore NULL.

Commenti

Dati contenuti nella struttura AM_SAMPLE2_PROPERTIES . È possibile specificare un subset delle proprietà di esempio impostando cbProperties su un valore minore delle dimensioni della struttura AM_SAMPLE2_PROPERTIES .

L'implementazione standard di questo metodo non supporta l'aggiornamento della struttura AM_SAMPLE2_PROPERTIES . Se questi membri non sono uguali a zero, il metodo restituisce E_INVALIDARG. Per modificare i dati contenuti nel buffer di memoria dell'esempio, chiamare IMediaSample::GetPointer.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia IMediaSample2