Descrizioni jack per i sottodispositivi audio dinamici

In Windows Vista e versioni successive, la proprietà KSPROPERTY_JACK_DESCRIPTION fornisce informazioni su un jack o una raccolta di jack in un sottodispositivo in una scheda audio. In questo contesto, il termine sottodevice è sinonimo di filtro KS. Il valore della proprietà è una matrice di una o più strutture KSJACK_DESCRIPTION . Ogni struttura descrive il colore, il tipo di connettore e la posizione fisica di un jack. Inoltre, la struttura contiene un membro IsConnected che è TRUE se un dispositivo endpoint audio, ad esempio un microfono o cuffie, è collegato al jack ed è FALSE se il jack è vuoto. Per fornire un valore aggiornato per IsConnected, il driver dell'adattatore per un subdevice dinamico si basa sulle funzionalità di rilevamento della presenza jack dell'hardware audio. Per un sottoinsieme statico (senza rilevamento della presenza jack), il membro IsConnected deve sempre essere TRUE. Per altre informazioni, vedere Proprietà Jack Description.

Quando l'utente inserisce un plug in un jack in un sottodevice dinamico, il driver dell'adattatore deve chiamare la funzione PcRegisterSubdevice per registrare il sottodevice. Mentre il sottodevice rimane registrato, se il driver dell'adattatore riceve un IOCTL contenente una richiesta di KSPROPERTY_JACK_DESCRIPTION per il subdevice, il driver deve impostare il membro IsConnected del valore della proprietà su TRUE.

Quando l'utente rimuove il plug dal jack sul sottodevice dinamico, il driver dell'adattatore deve chiamare il metodo IUnregisterSubdevice::UnregisterSubdevice per eliminare la registrazione del sottodevice. Sebbene il sottodevice non sia registrato, se il driver dell'adattatore riceve un IOCTL contenente una richiesta di KSPROPERTY_JACK_DESCRIPTION per il dispositivo secondario, il driver deve impostare il membro IsConnected del valore della proprietà su FALSE.