Metodo IControlInterface::GetName (devicetopology.h)

  • Articolo

Il metodo GetName ottiene il nome descrittivo per la funzione audio incapsula l'interfaccia di controllo.

Sintassi

HRESULT GetName(
  [out] LPWSTR *ppwstrName
);

Parametri

[out] ppwstrName

Puntatore a un puntatore di stringa in cui il metodo scrive l'indirizzo di una stringa con terminazione null, wide-character contenente il nome descrittivo. Il metodo alloca l'archiviazione per la stringa. Il chiamante è responsabile della liberazione dell'archiviazione, quando non è più necessario, chiamando la funzione CoTaskMemFree . Se la chiamata GetName ha esito negativo, *ppwstrName è NULL. Per informazioni su CoTaskMemFree, vedere la documentazione di Windows SDK.

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
 Puntatore ppwstrName è NULL.
E_OUTOFMEMORY
 Memoria insufficiente.

Commenti

Come esempio di nome descrittivo, un subunit con un'interfaccia IAudioPeakMeter potrebbe avere il nome descrittivo "misuratore di picco".

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 IAudioPeakMeter

Interfaccia IControlInterface