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

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

Синтаксис

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

Параметры

[out] ppParts

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

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

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

Замечания

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

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

Требования

См. также

Интерфейс IPart

Интерфейс IPartsList