Metodo IPart::GetLocalId (devicetopology.h)

Articolo
02/26/2024

Il metodo GetLocalId ottiene l'ID locale di questa parte.

Sintassi

HRESULT GetLocalId(
  [out] UINT *pnId
);

Parametri

[out] pnId

Puntatore a una variabile UINT in cui il metodo scrive l'ID locale di questa parte.

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_POINTER	Pointer pnId è NULL.

Commenti

Quando si dispone di un puntatore a un oggetto part, è possibile chiamare questo metodo per ottenere l'ID locale della parte. Un ID locale è un numero che identifica in modo univoco una parte tra tutte le parti in una topologia del dispositivo.

I Metodi IAudioInputSelector::GetSelection e IAudioOutputSelector::GetSelection recuperano l'ID locale di una parte connessa. IAudioInputSelector::SetSelection e IAudioOutputSelector::SetSelection seleziona l'input o l'output connesso a una parte identificata dall'ID locale. Il metodo IDeviceTopology::GetPartById ottiene una parte identificata dall'ID locale.

Per esempi di codice che usano il metodo GetLocalId , vedere gli argomenti seguenti:

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