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

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

Синтаксис

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

Параметры

[out] ppParts

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

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

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

Замечания

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

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

Пример кода, использующий метод EnumPartsOutgoing , см. в реализации функции SelectCaptureDevice в топологиях устройств.

Требования

См. также

Интерфейс IPart

Интерфейс IPartsList