Метод IDeviceTopology::GetDeviceId (devicetopology.h)

Метод GetDeviceId получает идентификатор устройства, представленного объектом топологии устройства.

Синтаксис

HRESULT GetDeviceId(
  [out] LPWSTR *ppwstrDeviceId
);

Параметры

[out] ppwstrDeviceId

Указатель на переменную указателя, в которую метод записывает адрес строки с расширенными символами, завершающейся null, которая содержит идентификатор устройства. Метод выделяет хранилище для строки. Вызывающий объект отвечает за освобождение хранилища, когда оно больше не требуется, путем вызова функции CoTaskMemFree . Если вызов GetDeviceId завершается ошибкой, *ppwstrDeviceId имеет значение NULL. Сведения о CoTaskMemFree см. в документации по Windows SDK.

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.

Код возврата	Описание
D_POINTER	Указатель ppwstrDeviceId имеет значение NULL.
E_OUTOFMEMORY	Недостаточно памяти.

Комментарии

Идентификатор устройства, полученный из этого метода, можно использовать в качестве входного параметра для метода IMMDeviceEnumerator::GetDevice .

Пример кода, в котором используется метод GetDeviceId , см. в разделе Использование интерфейса IKsControl для доступа к свойствам звука.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	devicetopology.h

См. также раздел

Интерфейс IDeviceTopology

IMMDeviceEnumerator::GetDevice