Metodo IControlInterface::GetName (devicetopology.h)
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 |
|---|---|
|
Puntatore ppwstrName è NULL. |
|
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 |