Méthode IWMDMMetaData ::QueryByIndex (mswmdm.h)

Article
02/29/2024

La méthode QueryByIndex récupère la valeur d’une propriété spécifiée par index.

Syntaxe

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

Paramètres

[in] iIndex

Entier spécifiant l’index de base zéro de la propriété. Le nombre d’éléments est obtenu via l’appel GetItemCount .

[out] ppwszName

Nom de la propriété. Windows Media Gestionnaire de périphériques alloue cette mémoire et l’appelant doit la libérer à l’aide de CoTaskMemFree.

[out] pType

Une WMDM_TAG_DATATYPE valeur énumérée décrivant le type de données retournées dans ppValue.

[out] ppValue

Pointeur vers un pointeur vers un tableau d’octets qui reçoit le contenu de la valeur si la méthode réussit. Cette mémoire est allouée par Windows Media Gestionnaire de périphériques et l’appelant doit la libérer à l’aide de CoTaskMemFree.

[out] pcbLength

Pointeur vers la taille, en octets, du tableau d’octets ppValue. Si la valeur est une chaîne, cela inclut le caractère de fin.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :