Поделиться через


Метод IPartsList::GetPart (devicetopology.h)

Метод GetPart получает часть из списка частей.

Синтаксис

HRESULT GetPart(
  [in]  UINT  nIndex,
  [out] IPart **ppPart
);

Параметры

[in] nIndex

Номер части извлекаемой части. Если список частей содержит n частей, части нумеруются от 0 до n–1. Вызовите метод IPartsList::GetCount , чтобы получить количество частей в списке.

[out] ppPart

Указатель на переменную указателя, в которую метод записывает адрес интерфейса IPart объекта part. С помощью этого метода вызывающий объект получает подсчитываемую ссылку на интерфейс IPart . Вызывающий объект отвечает за освобождение интерфейса, когда он больше не нужен, путем вызова метода Release интерфейса. Если вызов GetPart завершается сбоем, *ppPart имеет значение NULL.

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

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

Код возврата Описание
E_INVALIDARG
Параметр nIndex выходит за пределы диапазона.
E_POINTER
Указатель ppPart имеет значение NULL.

Комментарии

Пример кода, вызывающий метод GetPart , см. в разделе Реализация функции SelectCaptureDevice в разделе Топологии устройств.

Требования

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

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

Интерфейс IPart

Интерфейс IPartsList

IPartsList::GetCount