Metodo IMediaPropertyBag::EnumProperty (strmif.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il EnumProperty metodo recupera una coppia di proprietà/valore.
Sintassi
HRESULT EnumProperty(
[in] ULONG iProperty,
[in, out] VARIANT *pvarPropertyName,
[in, out] VARIANT *pvarPropertyValue
);
Parametri
[in] iProperty
Valore di indice della coppia.
[in, out] pvarPropertyName
Puntatore a un VALORE VARIANT che riceve il nome della proprietà.
[in, out] pvarPropertyValue
Puntatore a un valore VARIANT che riceve il valore della proprietà.
Valore restituito
Restituisce un valore HRESULT . I possibili valori sono i seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
Argomento non valido. |
|
Memoria insufficiente. |
|
Argomento puntatore NULL. |
|
Indice non compreso nell'intervallo. |
Commenti
Il nome è sempre una stringa. Impostare il tipo variant del parametro pvarPropertyName su VT_EMPTY o VT_BSTR prima di chiamare questo metodo.
Il valore può essere una stringa (per blocchi INFO) o una matrice di byte (per blocchi DISP). Impostare il tipo variant del parametro pvarPropertyName su VT_EMPTY, VT_BSTR o (VT_ARRAY | VT_UI1).
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 |