Metodo IMFAttributes::GetItemByIndex (mfobjects.h)

Articolo
03/15/2023

Recupera un attributo in corrispondenza dell'indice specificato.

Sintassi

HRESULT GetItemByIndex(
  [in]      UINT32      unIndex,
  [out]     GUID        *pguidKey,
  [in, out] PROPVARIANT *pValue
);

Parametri

[in] unIndex

Indice dell'attributo da recuperare. Per ottenere il numero di attributi, chiamare IMFAttributes::GetCount.

[out] pguidKey

Riceve il GUID che identifica questo attributo.

[in, out] pValue

Puntatore a un PROPVARIANT che riceve il valore. Questo parametro può essere NULL. Se non è NULL, il metodo riempie PROPVARIANT con una copia del valore dell'attributo. Chiamare PropVariantClear per liberare la memoria allocata da questo metodo.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	Indice non valido.

Commenti

Per enumerare tutti gli attributi di un oggetto in modo thread-safe, eseguire le operazioni seguenti:

Chiamare IMFAttributes::LockStore per impedire a un altro thread di aggiungere o eliminare attributi.
Chiamare IMFAttributes::GetCount per trovare il numero di attributi.
Chiamare GetItemByIndex per ottenere ogni attributo per indice.
Chiamare IMFAttributes::UnlockStore per sbloccare l'archivio attributi.

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

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à

IMFAttributes

Condividi tramite