Метод IDeviceTopology::GetSubunit (devicetopology.h)

Статья
08/23/2023

Метод GetSubunit получает подсоединение, указанное номером вложенной единицы.

Синтаксис

HRESULT GetSubunit(
  [in]  UINT     nIndex,
  [out] ISubunit **ppSubunit
);

Параметры

[in] nIndex

Номер подсоединия. Если топология устройства содержит n подсоединений, они нумеруются от 0 до n–1. Чтобы получить количество подъединиц в топологии устройства, вызовите метод IDeviceTopology::GetSubunitCount .

[out] ppSubunit

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

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

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

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

Требования


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

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

Интерфейс IDeviceTopology

IDeviceTopology::GetSubunitCount

Интерфейс ISubunit