Metodo IControlInterface::GetName (devicetopology.h)
Il metodo GetName ottiene il nome descrittivo per la funzione audio incapsulato dall'interfaccia del 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 di caratteri wide con terminazione Null contenente il nome descrittivo. Il metodo alloca l'archiviazione per la stringa. Il chiamante è responsabile della liberazione dello spazio di 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, restituisce S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il puntatore ppwstrName è NULL. |
|
Memoria insufficiente. |
Osservazioni
Come esempio di nome descrittivo, una subunit con un interfaccia IAudioPeakMeter potrebbe avere il nome descrittivo "picco contatore".
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista [solo app desktop] |
| server minimo supportato | Windows Server 2008 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione | devicetopology.h |
Vedere anche
interfaccia IAudioPeakMeter
interfaccia IControlInterface