Compartir a través de

Roles de dispositivo para aplicaciones directSound

Nota

El de LA API MMDevice de admite roles de dispositivo. Sin embargo, la interfaz de usuario de Windows Vista no implementa compatibilidad con esta característica. Es posible que la compatibilidad con la interfaz de usuario para roles de dispositivo se implemente en una versión futura de Windows. Para obtener más información, vea Roles de dispositivo en Windows Vista.

 

DirectSound API no proporciona un medio para que una aplicación seleccione el dispositivo de punto de conexión de audio que el usuario ha asignado a un rol de dispositivo determinado. Sin embargo, en Windows Vista, las API de audio principales se pueden usar junto con una aplicación directSound para habilitar la selección de dispositivos en función del rol de dispositivo. Con la ayuda de las API de audio principales, la aplicación puede identificar el dispositivo de punto de conexión de audio asignado a un rol determinado, obtener el GUID del dispositivo DirectSound para el dispositivo de punto de conexión y llamar a la DirectSoundCreate o función DirectSoundCaptureCreate para crear un IDirectSound o instancia de interfaz IDirectSoundCapture que encapsula el dispositivo de punto de conexión. Para obtener más información sobre DirectSound, consulte la documentación de Windows SDK.

En el ejemplo de código siguiente se muestra cómo obtener el GUID del dispositivo DirectSound para el dispositivo de representación o captura asignado actualmente a un rol de dispositivo determinado:

//-----------------------------------------------------------
// Get the DirectSound or DirectSoundCapture device GUID for
// an audio endpoint device. If flow = eRender, the function
// gets the DirectSound device GUID for the rendering device
// with the specified device role. If flow = eCapture, the
// function gets the DirectSoundCapture device GUID for the
// capture device with the specified device role.
//-----------------------------------------------------------
#define EXIT_ON_ERROR(hr)  \
              if (FAILED(hr)) { goto Exit; }
#define SAFE_RELEASE(punk)  \
              if ((punk) != NULL)  \
                { (punk)->Release(); (punk) = NULL; }

HRESULT GetDirectSoundGuid(EDataFlow flow, ERole role, GUID* pDevGuid)
{
    HRESULT hr = S_OK;
    IMMDeviceEnumerator *pEnumerator = NULL;
    IMMDevice *pDevice = NULL;
    IPropertyStore *pProps = NULL;

    PROPVARIANT var;
    PropVariantInit(&var);

    if (pDevGuid == NULL)
    {
        return E_POINTER;
    }

    // Get a device enumerator for the audio endpoint
    // devices in the system.
    hr = CoCreateInstance(__uuidof(MMDeviceEnumerator),
                          NULL, CLSCTX_INPROC_SERVER,
                          __uuidof(IMMDeviceEnumerator),
                          (void**)&pEnumerator);
    EXIT_ON_ERROR(hr)

    // Get the endpoint device with the specified dataflow
    // direction (eRender or eCapture) and device role.
    hr = pEnumerator->GetDefaultAudioEndpoint(flow, role,
                                              &pDevice);
    EXIT_ON_ERROR(hr)

    hr = pDevice->OpenPropertyStore(STGM_READ, &pProps);
    EXIT_ON_ERROR(hr)

    // Get the DirectSound or DirectSoundCapture device GUID
    // (in WCHAR string format) for the endpoint device.
    hr = pProps->GetValue(PKEY_AudioEndpoint_GUID, &var);
    EXIT_ON_ERROR(hr)

    // Convert the WCHAR string to a GUID structure.
    hr = CLSIDFromString(var.pwszVal, pDevGuid);
    EXIT_ON_ERROR(hr)

Exit:
    PropVariantClear(&var);
    SAFE_RELEASE(pEnumerator);
    SAFE_RELEASE(pDevice);
    SAFE_RELEASE(pProps);
    return hr;
}

En el ejemplo de código anterior, la función GetDirectSoundGuid acepta una dirección de flujo de datos (eRender o eCapture) y un rol de dispositivo (eConsole, eMultimedia o eCommunications) como parámetros de entrada. El tercer parámetro es un puntero a través del cual la función escribe un GUID de dispositivo que la aplicación puede proporcionar como parámetro de entrada al DirectSoundCreate o función DirectSoundCaptureCreate.

En el ejemplo de código anterior se obtiene el GUID del dispositivo DirectSound mediante:

  • Creación de una instancia de interfazIMMDevice que representa el dispositivo de punto de conexión de audio que tiene la dirección del flujo de datos y el rol de dispositivo especificados.
  • Apertura del almacén de propiedades del dispositivo de punto de conexión de audio.
  • Obtener la propiedad PKEY_AudioEndpoint_GUID del almacén de propiedades. El valor de la propiedad es una representación de cadena del GUID del dispositivo DirectSound para el dispositivo de punto de conexión de audio.
  • Llamar a la función CLSIDFromStringpara convertir la representación de cadena del GUID del dispositivo en una estructura GUID. Para obtener más información sobre CLSIDFromString, consulte la documentación de Windows SDK.

Después de obtener un GUID de dispositivo de la función GetDirectSoundGuid, la aplicación puede llamar a DirectSoundCreate o DirectSoundCaptureCreate con este GUID para crear el dispositivo de representación o captura de DirectSound que encapsula el dispositivo de punto de conexión de audio. Cuando DirectSound crea un dispositivo de esta manera, siempre asigna la secuencia de audio del dispositivo a la sesión predeterminada, la sesión de audio específica del proceso identificada por el valor guid de sesión GUID_NULL.

Si la aplicación requiere que DirectSound asigne la secuencia a una sesión de audio entre procesos o a una sesión con un GUID de sesión que no seaNULL, debe llamar al método IMMDevice::Activate para crear un IDirectSound o IDirectSoundCapture objeto en lugar de usar la técnica que se muestra en el ejemplo de código anterior. Para obtener un ejemplo de código que muestra cómo usar el método activate de para especificar una sesión de audio entre procesos oun GUID de sesión de NULL para una secuencia, consulte Roles de dispositivo para DirectShow Applications. El ejemplo de código de esa sección muestra cómo crear un filtro DirectShow, pero, con modificaciones menores, el código se puede adaptar para crear un dispositivo DirectSound.

La función GetDirectSoundGuid del ejemplo de código anterior llama a la función CoCreateInstance para crear un enumerador para los dispositivos de punto de conexión de audio del sistema. A menos que el programa de llamada llame previamente a la función CoInitialize o CoInitializeEx para inicializar la biblioteca COM, se producirá un error en la llamada CoCreateInstance. Para obtener más información sobre CoCreateInstance, CoInitializey CoInitializeEx, consulte la documentación de Windows SDK.

interoperabilidad con las API de audio heredadas