Compartir a través de

Método IDeviceTopology::GetDeviceId (devicetopology.h)

  • Artículo

El método GetDeviceId obtiene el identificador de dispositivo del dispositivo representado por el objeto device-topology.

Sintaxis

HRESULT GetDeviceId(
  [out] LPWSTR *ppwstrDeviceId
);

Parámetros

[out] ppwstrDeviceId

Puntero a una variable de puntero en la que el método escribe la dirección de una cadena de caracteres anchos terminada en NULL que contiene el identificador del dispositivo. 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 GetDeviceId , *ppwstrDeviceId 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
D_POINTER
 El puntero ppwstrDeviceId es NULL.
E_OUTOFMEMORY
 Memoria insuficiente

Comentarios

El identificador de dispositivo obtenido de este método se puede usar como parámetro de entrada para el método IMMDeviceEnumerator::GetDevice .

Para obtener un ejemplo de código que usa el método GetDeviceId , vea Using the IKsControl Interface to Access Audio Properties.

Requisitos

Requisito Value
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

IDeviceTopology (Interfaz)

IMMDeviceEnumerator::GetDevice