Método IDeviceTopology::GetSubunit (devicetopology.h)

Artigo
08/23/2023

O método GetSubunit obtém a subunidade especificada por um número de subunidade.

Sintaxe

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

Parâmetros

[in] nIndex

O número de subunidade. Se uma topologia de dispositivo contiver n subunidades, as subunidades serão numeradas de 0 a n– 1. Para obter o número de subunidades na topologia do dispositivo, chame o método IDeviceTopology::GetSubunitCount .

[out] ppSubunit

Ponteiro para uma variável de ponteiro na qual o método grava o endereço da interface ISubunit do objeto subunit. Por meio desse método, o chamador obtém uma referência contada à interface . O chamador é responsável por liberar a interface, quando ela não é mais necessária, chamando o método Release da interface. Se a chamada GetSubunit falhar, *ppSubunit será NULL.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno	Descrição
E_INVALIDARG	O parâmetro nIndex está fora do intervalo.
E_POINTER	O ponteiro ppSubunit é NULL.

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	devicetopology.h

Confira também

IDeviceTopology Interface

IDeviceTopology::GetSubunitCount

ISubunit Interface

Compartilhar via