Método IKsFormatSupport::GetDevicePreferredFormat (devicetopology.h)

Artículo
02/28/2024

El método GetDevicePreferredFormat obtiene el formato de secuencia de audio preferido para la conexión.

Sintaxis

HRESULT GetDevicePreferredFormat(
  [out] PKSDATAFORMAT *ppKsFormat
);

Parámetros

[out] ppKsFormat

Puntero a una variable de puntero en la que el método escribe la dirección de un búfer que contiene el especificador de formato para el formato preferido. El especificador comienza con una estructura KSDATAFORMAT que podría seguir la información de formato adicional. El método asigna el almacenamiento para el especificador de formato. 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 el método, *ppKsFormat es NULL. Para obtener más información sobre KSDATAFORMAT, especificadores de formato y CoTaskMemFree, consulte la documentación de DDK de Windows.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

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

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

IKsFormatSupport (interfaz)