KSPROPERTY_JACK_DESCRIPTION3

Właściwość KSPROPERTY_JACK_DESCRIPTION3 jest implementowana jako właściwość typu pin-wise, która jest uzyskiwana przy użyciu uchwytu filtru.

W wersji 22H2 i nowszych systemach operacyjnych Windows skojarzona struktura KSJACK_DESCRIPTION3 może służyć do określania i zmieniania bieżącej konfiguracji gniazda.

Tabela podsumowania użycia

Wartość właściwości (dane wystąpienia) jest KSMULTIPLE_ITEM, a następnie tablicą struktur KSJACK_DESCRIPTION3.

Wartość zwracana

Żądanie właściwości KSPROPERTY_JACK_DESCRIPTION3 zwraca KSMULTIPLE_ITEM, a następnie tablicę N KSJACK_DESCRIPTION3 struktur, gdzie N = liczba gniazd skojarzonych z określonym wyprowadzkiem mostka. Na poniższej liście przedstawiono elementy zwracane przez żądanie właściwości.

KSMULTIPLE_ITEM. Rozmiar = sizeof(KSMULTIPLE_ITEM) + N * sizeof(KSJACK_DESCRIPTION3)

KSMULTIPLE_ITEM. Liczba = N

KSJACK_DESCRIPTION3[0]

...\

KSJACK_DESCRIPTION3[N-1]

Uwagi

Komunikacja zmian urządzenia audio przy użyciu KSJACK_DESCRIPTION3 i KSPROPERTY_JACK_DESCRIPTION3

System audio systemu Windows buforuje możliwości urządzenia audio podczas tworzenia punktu końcowego audio. Te buforowane wartości są przeznaczone dla funkcji, takich jak obecność aparatu audio HW, obsługa formatu, identyfikator kontenera, charakterystykę rozmiaru buforu itp. Te buforowane wartości są zachowywane przez okres eksploatacji instalacji systemu Windows. Są one odświeżane tylko wtedy, gdy sterownik audio jest aktualizowany lub podczas uaktualniania systemu operacyjnego.

W przypadku KSJACK_DESCRIPTION3 system audio systemu Windows udostępnia mechanizm, aby sterownik audio zażądał odrzucenia i odświeżenia wszystkich buforowanych wartości. Żądanie może zostać wyzwolone przez zmiany w funkcjach urządzenia audio, takich jak ograniczenia zasobów.

Za każdym razem, gdy sterownik zmienia zawartość KSJACK_DESCRIPTION3 w czasie wykonywania, sterownik wyzwoli istniejące zdarzenie KSEVENT_PINCAPS_JACKINFOCHANGE .

System audio systemu Windows utrzymuje ostatnią zgłoszoną wartość ConfigId buforowana w punkcie końcowym dźwięku. Wartość ConfigId jest pobierana w odpowiedzi na zdarzenie KSEVENT_PINCAPS_JACKINFOCHANGE i podczas normalnego przetwarzania punktu końcowego dźwięku podczas rozruchu systemu, ponowne uruchomienie usługi Audio Endpoint Builder, aktualizacja sterownika audio lub zmiany stanu interfejsu dla punktu końcowego.

Jeśli pobrana wartość ConfigId różni się od wcześniej przechowywanej wartości, system audio systemu Windows odrzuci wszystkie wcześniej buforowane możliwości punktu końcowego i odświeży je.

Zalecane użycie polega na zdefiniowaniu wielu konfiguracji punktu końcowego audio w sterowniku, który jest kontrolowany przez wartość ConfigId (maska bitów lub wyliczenie). Na przykład identyfikator ConfigId 1 może wskazywać na obecność węzła aparatu audio, natomiast identyfikator ConfigId 2 nie zgłasza węzła aparatu audio. Identyfikator ConfigId używany przez sterownik jest udostępniany systemowi audio systemu Windows za pośrednictwem KSPROPERTY_JACK_DESCRIPTION3 i działa w celu zsynchronizowania punktu końcowego z możliwościami buforowanym przez system audio systemu Windows.

Wartość ConfigId jest nieprzezroczysta dla systemu Windows. Sterownik audio może użyć znacznika czasu lub przyrostowej wartości wybranej w czasie wykonywania zamiast maski bitowej lub wyliczenia, jak pokazano powyżej. Ta strategia nie jest zalecana, ponieważ może spowodować niepotrzebne odświeżenia punktu końcowego podczas rozruchu lub zmiany interfejsu w celu zsynchronizowania ostatniej przechowywanej wartości ConfigId z nowo zgłoszoną wartością, nawet jeśli możliwości punktu końcowego nie zostaną zmienione. Takie podejście może również zwiększyć prawdopodobieństwo, że sterownik i system Windows nie będą zsynchronizowane, co może spowodować błędy odtwarzania dźwięku.

Mechanizm używany do odświeżania buforowanych wartości w punkcie końcowym, gdy zmienia się identyfikator ConfigId , jest taki sam, jak w przypadku uaktualnień systemu operacyjnego i aktualizacji sterowników. Zostanie utworzony nowy punkt końcowy z innym identyfikatorem, który będzie zawierać odświeżone wartości buforowane zgodne z nowymi ustawieniami identyfikatora ConfigId punktu końcowego, ustawienia użytkownika są następnie kopiowane ze starego punktu końcowego do nowego punktu końcowego, a na koniec stary punkt końcowy zostanie usunięty. Aby uzyskać więcej informacji, na temat procesu migracji punktu końcowego audio w uaktualnieniach systemu operacyjnego, zobacz Uaktualnienia systemu operacyjnego.

Wymagania

Zobacz również

KSJACK_DESCRIPTION3

KSMULTIPLE_ITEM

Uaktualnienia systemu operacyjnego