Метод IWMDMMetaData::QueryByIndex (mswmdm.h)
Метод QueryByIndex извлекает значение свойства, указанного индексом.
Синтаксис
HRESULT QueryByIndex(
[in] UINT iIndex,
[out] WCHAR **ppwszName,
[out] WMDM_TAG_DATATYPE *pType,
[out] BYTE **ppValue,
[out] UINT *pcbLength
);
Параметры
[in] iIndex
Целое число, указывающее отсчитываемый от нуля индекс свойства. Количество элементов получается с помощью вызова GetItemCount .
[out] ppwszName
Имя свойства. Windows Media диспетчер устройств выделяет эту память, и вызывающий объект должен освободить ее с помощью CoTaskMemFree.
[out] pType
WMDM_TAG_DATATYPE перечислимое значение, описывающее тип данных, возвращаемых в ppValue.
[out] ppValue
Указатель на указатель на массив байтов, который получает содержимое значения при успешном выполнении метода. Эта память выделяется windows Media диспетчер устройств, и вызывающий объект должен освободить ее с помощью CoTaskMemFree.
[out] pcbLength
Указатель на размер массива байтов ppValue (в байтах). Если значение является строкой, это включает символ завершения.
Возвращаемое значение
Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:
- Стандартные коды ошибок COM
- Коды ошибок Windows, преобразованные в значения HRESULT
- Коды ошибок диспетчер устройств Windows Media
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | mswmdm.h |
Библиотека | Mssachlp.lib |