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

  • Статья

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

Синтаксис

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

Параметры

[out] ppParts

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

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

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

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

Комментарии

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

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

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

Требования

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

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

Интерфейс IPart

Интерфейс IPartsList