Metodo IMFAttributes::SetItem (mfobjects.h)

Articolo
03/05/2024

Aggiunge un valore di attributo con una chiave specificata.

Sintassi

HRESULT SetItem(
  [in] REFGUID        guidKey,
  [in] REFPROPVARIANT Value
);

Parametri

[in] guidKey

GUID che identifica il valore da impostare. Se questa chiave esiste già, il metodo sovrascrive il valore precedente.

[in] Value

PropVARIANT che contiene il valore dell'attributo. Il metodo copia il valore. Il tipo PROPVARIANT deve essere uno dei tipi elencati nell'enumerazione MF_ATTRIBUTE_TYPE .

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_OUTOFMEMORY	Memoria insufficiente.
MF_E_INVALIDTYPE	Tipo di attributo non valido.

Commenti

Questo metodo verifica se il tipo PROPVARIANT è uno dei tipi di attributo definiti in MF_ATTRIBUTE_TYPE e ha esito negativo se viene usato un tipo non supportato. Tuttavia, questo metodo non verifica se PROPVARIANT è il tipo corretto per il GUID dell'attributo specificato. Non è possibile associare GUID di attributo a livello di codice ai tipi di proprietà. Per un elenco di attributi di Media Foundation e dei relativi tipi di dati, vedere Attributi di Media Foundation.

Questa interfaccia è disponibile nelle piattaforme seguenti se i componenti ridistribuibili di Windows Media Format 11 SDK sono installati:

Windows XP con Service Pack 2 (SP2) e versioni successive.
Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfobjects.h (include Mfidl.h)
Libreria	Mfuuid.lib

Vedi anche

Attributi e proprietà

FMAttributes

Condividi tramite