Metodo IDeviceTopology::GetSubunit (devicetopology.h)

Il metodo GetSubunit ottiene la subunit specificata da un numero di subunit.

Sintassi

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

Parametri

[in] nIndex

Numero di subunit. Se una topologia del dispositivo contiene n sottounite, le sottounite vengono numerate da 0 a n- 1. Per ottenere il numero di sottounite nella topologia del dispositivo, chiamare il metodo IDeviceTopology::GetSubunitCount .

[out] ppSubunit

Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo dell'interfaccia ISubunit dell'oggetto subunit . Tramite questo metodo, il chiamante ottiene un riferimento conteggiato all'interfaccia. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata GetSubunit ha esito negativo, *ppSubunit è NULL.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Codice restituito	Descrizione
E_INVALIDARG	Il parametro nIndex non è compreso nell'intervallo.
E_POINTER	Il puntatore ppSubunit è NULL.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	devicetopology.h

Vedi anche

Interfaccia IDeviceTopology

IDeviceTopology::GetSubunitCount

Interfaccia ISubunit