Metodo IWMDMMetaData::QueryByIndex (mswmdm.h)

Articolo
02/29/2024

Il metodo QueryByIndex recupera il valore di una proprietà specificata dall'indice.

Sintassi

HRESULT QueryByIndex(
  [in]  UINT              iIndex,
  [out] WCHAR             **ppwszName,
  [out] WMDM_TAG_DATATYPE *pType,
  [out] BYTE              **ppValue,
  [out] UINT              *pcbLength
);

Parametri

[in] iIndex

Intero che specifica l'indice in base zero della proprietà. Il numero di elementi viene ottenuto tramite la chiamata GetItemCount .

[out] ppwszName

Nome della proprietà. Windows Media Gestione dispositivi alloca questa memoria e il chiamante deve liberarlo usando CoTaskMemFree.

[out] pType

Valore WMDM_TAG_DATATYPE enumerato che descrive il tipo di dati restituiti in ppValue.

[out] ppValue

Puntatore a un puntatore a una matrice di byte che riceve il contenuto del valore se il metodo ha esito positivo. Questa memoria viene allocata da Windows Media Gestione dispositivi e il chiamante deve liberarlo usando CoTaskMemFree.

[out] pcbLength

Puntatore alle dimensioni, in byte, della matrice di byte ppValue. Se il valore è una stringa, questo include il carattere di terminazione.

Valore restituito

Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti: