Descripciones de Jack para subdispositivos de audio dinámico

En Windows Vista y versiones posteriores, la propiedad KSPROPERTY_JACK_DESCRIPTION proporciona información sobre un conector o una colección de conectores en un subdispositivo en un adaptador de audio. (En este contexto, el término subdispositivo es sinónimo de filtro KS). El valor de propiedad es una matriz de una o varias estructuras KSJACK_DESCRIPTION . Cada estructura describe el color, el tipo de conector y la ubicación física de un conector. Además, la estructura contiene un miembro IsConnected que es TRUE si un dispositivo de extremo de audio, como un micrófono o auriculares, está conectado al conector y es FALSE si el conector está vacío. Para proporcionar un valor actualizado para IsConnected, el controlador del adaptador para un subdispositivo dinámico se basa en las funcionalidades de detección de presencia de jack del hardware de audio. Para un subdispositivo estático (sin detección de presencia de jack), el miembro IsConnected siempre debe ser TRUE. Para obtener más información, vea Jack Description (propiedad).

Cuando el usuario inserta un enchufe en un conector en un subdispositivo dinámico, el controlador del adaptador debe llamar a la función PcRegisterSubdevice para registrar el subdevice. Mientras el subdispositivo permanece registrado, si el controlador del adaptador recibe un IOCTL que contiene una solicitud de KSPROPERTY_JACK_DESCRIPTION para el subdispositivo, el controlador debe establecer el miembro IsConnected del valor de propiedad en TRUE.

Cuando el usuario quita el enchufe del conector en el subdispositivo dinámico, el controlador del adaptador debe llamar al método IUnregisterSubdevice::UnregisterSubdevice para eliminar el registro del subdevice. Aunque el subdispositivo no está registrado, si el controlador del adaptador recibe un IOCTL que contiene una solicitud de KSPROPERTY_JACK_DESCRIPTION para el subdispositivo, el controlador debe establecer el miembro IsConnected del valor de propiedad en FALSE.