Share via

Метод IPart::EnumPartsIncoming (devicetopology.h)

  • Статья

Метод EnumPartsIncoming получает список всех входящих частей, то есть частей, находящихся в путях к данным, которые вышестоящий из этой части.

Синтаксис

HRESULT EnumPartsIncoming(
  [out] IPartsList **ppParts
);

Параметры

[out] ppParts

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

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

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

Код возврата Описание
E_POINTER
 Параметр ppParts указателя имеет значение NULL.
E_NOTFOUND
 Эта часть не имеет связей с вышестоящий частями.
E_OUTOFMEMORY
 Недостаточно памяти.

Комментарии

Клиентское приложение может обходить топологию устройства в направлении потока аудиоданных, итеративно вызывая этот метод на каждом шаге обхода, чтобы получить список частей, которые находятся непосредственно вышестоящий из текущей части.

Если эта часть не имеет ссылок на вышестоящий части, метод возвращает код ошибки E_NOTFOUND и не создает список частей (*ppParts имеет значение NULL). Например, метод возвращает этот код ошибки, если интерфейс IPart представляет соединитель, через который данные входят в топологию устройства.

Требования

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

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

Интерфейс IPart

Интерфейс IPartsList