Método IDeviceTopology::GetSubunit (devicetopology.h)
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 |
|---|---|
|
O parâmetro nIndex está fora do intervalo. |
|
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 |