Metodo IDeviceTopology::GetPartById (devicetopology.h)

Articolo
08/23/2023

Il metodo GetPartById ottiene una parte identificata dall'ID locale.

Sintassi

HRESULT GetPartById(
  [in]  UINT  nId,
  [out] IPart **ppPart
);

Parametri

[in] nId

Parte da ottenere. Questo parametro è l'ID locale della parte. Per altre informazioni, vedere la sezione Osservazioni.

[out] ppPart

Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo dell'interfaccia IPart dell'oggetto parte identificato da nId. 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 GetPartById ha esito negativo, *ppPart è NULL.

Valore restituito

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

Codice restituito	Descrizione
E_INVALIDARG	Il parametro nId non è un ID locale valido.
E_POINTER	Il puntatore ppPart è NULL.

Commenti

Un ID locale è un numero che identifica in modo univoco una parte tra tutte le parti di una topologia del dispositivo. I metodi IAudioInputSelector::GetSelection e IAudioOutputSelector::GetSelection recuperano l'ID locale di una parte connessa. I metodi IAudioInputSelector::SetSelection e IAudioOutputSelector::SetSelection selezionano l'input o l'output connesso a una parte identificata dal relativo ID locale. Quando si dispone di un puntatore a un oggetto part, è possibile chiamare il metodo IPart::GetLocalId per ottenere l'ID locale della parte.

Requisiti

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