Método IControlInterface::GetName (devicetopology.h)

El método GetName obtiene el nombre descriptivo de la función de audio que la interfaz de control encapsula.

Sintaxis

HRESULT GetName(
  [out] LPWSTR *ppwstrName
);

Parámetros

[out] ppwstrName

Puntero a un puntero de cadena en el que el método escribe la dirección de una cadena de caracteres anchos terminada en NULL que contiene el nombre descriptivo. El método asigna el almacenamiento para la cadena. El autor de la llamada es responsable de liberar el almacenamiento, cuando ya no es necesario, llamando a la función CoTaskMemFree . Si se produce un error en la llamada a GetName , *ppwstrName es NULL. Para obtener información sobre CoTaskMemFree, consulte la documentación de Windows SDK.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto	Descripción
E_POINTER	El puntero ppwstrName es NULL.
E_OUTOFMEMORY	Memoria insuficiente

Comentarios

Como ejemplo de un nombre descriptivo, una subunidad con una interfaz IAudioPeakMeter podría tener el nombre descriptivo "medidor máximo".

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	devicetopology.h

Consulte también

Interfaz IAudioPeakMeter

IControlInterface (Interfaz)