Jack Descriptions for Dynamic Audio Subdevices

In Windows Vista und höher stellt die eigenschaft KSPROPERTY_JACK_DESCRIPTION Informationen zu einer Buchse oder einer Sammlung von Buchsen auf einem Untergerät in einem Audioadapter bereit. (In diesem Zusammenhang ist der Begriff untergeräte synonym mit KS-Filter.) Der Eigenschaftswert ist ein Array einer oder mehrerer KSJACK_DESCRIPTION Strukturen. Jede Struktur beschreibt die Farbe, den Verbindertyp und den physischen Standort einer Buchse. Darüber hinaus enthält die Struktur einen IsConnected-Member , der TRUE ist, wenn ein Audioendpunktgerät wie ein Mikrofon oder Kopfhörer an die Buchse angeschlossen ist, und false ist, wenn die Buchse leer ist. Um einen aktuellen Wert für IsConnected bereitzustellen, basiert der Adaptertreiber für ein dynamisches Untergerät auf den Erkennungsfunktionen der Audiohardware. Für ein statisches Untergerät (ohne Jack-Presence-Erkennung) sollte das IsConnected-Element immer TRUE sein. Weitere Informationen finden Sie unter Jack Description Property.

Wenn der Benutzer einen Stecker in eine Buchse eines dynamischen Untergeräts einfügt, sollte der Adaptertreiber die PcRegisterSubdevice-Funktion aufrufen, um das Untergerät zu registrieren. Während das Untergerät registriert bleibt, sollte der Treiber das IsConnected-Element des Eigenschaftswerts auf TRUE festlegen, wenn der Adaptertreiber eine IOCTL mit einer KSPROPERTY_JACK_DESCRIPTION Anforderung für das Untergerät empfängt.

Wenn der Benutzer den Stecker aus der Buchse des dynamischen Untergerätes entfernt, sollte der Adaptertreiber die IUnregisterSubdevice::UnregisterSubdevice-Methode aufrufen, um die Registrierung des Untergerätes zu löschen. Obwohl das Untergerät nicht registriert ist, sollte der Treiber, wenn der Adaptertreiber eine IOCTL mit einer KSPROPERTY_JACK_DESCRIPTION Anforderung für das Untergerät enthält, den IsConnected-Member des Eigenschaftswerts auf FALSE festlegen.