Żądania właściwości audio

Klienci sterownika audio Microsoft Windows Driver Model (WDM) mogą wysyłać żądania właściwości KS do filtrów KS i gniazda, które sterownik utworzył. Na przykład klient trybu użytkownika może wysłać żądanie właściwości KS, wywołując funkcję DeviceIoControl (zobacz dokumentację zestawu SDK systemu Microsoft Windows) za pomocą kodu kontroli we/wy IOCTL_KS_PROPERTY. Ta funkcja wysyła IRP zawierające żądanie dotyczące właściwości do określonego filtru lub obiektu pinu.

Sterowniki audio obsługują żądania pobierania, ustawiania i podstawowej pomocy technicznej dotyczących właściwości (KSPROPERTY_TYPE_GET, KSPROPERTY_TYPE_SET i KSPROPERTY_TYPE_BASICSUPPORT). Aby uzyskać więcej informacji, zobacz Zestawy właściwości sterowników audio.

Klient może wysyłać żądania dotyczące trzech rodzajów właściwości: właściwości filtru, właściwości pinu i właściwości węzła. Aby uzyskać więcej informacji, zobacz Właściwości filtru, blokady i węzła.

Podczas wysyłania żądania dotyczącego właściwości filtra do obiektu filtra, klient określa docelowy filtr poprzez uchwyt jego instancji (zobacz Fabryki filtrów). Podobnie, podczas wysyłania żądania dotyczącego właściwości pinu do obiektu pinu, docelowy pin jest określany za pomocą uchwytu wystąpienia (zobacz Fabryki pinów). Dowolny typ żądania zawiera strukturę KSPROPERTY , która określa następujące elementy:

• Identyfikator GUID identyfikujący zestaw właściwości

• Indeks identyfikujący element właściwości w określonym zestawie właściwości

• Flagi wskazujące typ żądania właściwości (get, set lub podstawowe wsparcie)

Powiązane właściwości są zbierane razem w celu utworzenia zestawu właściwości. Określona właściwość jest identyfikowana przez jej zestaw właściwości i przez indeks, który określa jego pozycję w tym zestawie.

Żądanie właściwości węzła zawiera strukturę KSNODEPROPERTY, która łączy strukturę KSPROPERTY i identyfikator węzła. W zależności od właściwości node element docelowy żądania właściwości jest wystąpieniem filtru lub wystąpieniem numeru PIN.

Jeśli filtr może utworzyć więcej niż jedno wystąpienie określonego typu węzła, element docelowy żądania jest określony przez uchwyt pinu. Uchwyt identyfikuje wystąpienie pinu na początku lub na końcu ścieżki danych, na której znajduje się wystąpienie węzła. W przypadku filtru zawierającego węzeł SUM lub MUX (zobacz KSNODETYPE_SUM i KSNODETYPE_MUX) obowiązują następujące reguły:

• Jeśli właściwość należy do węzła, który znajduje się podrzędnie z numeru PIN ujścia (wejściowego) i nadrzędnego z węzła SUM lub MUX, żądanie właściwości jest wysyłane do numeru PIN ujścia.

• Jeśli właściwość należy do węzła, który znajduje się niżej niż węzeł SUM lub MUX i powyżej pinu źródłowego (wyjściowego), żądanie właściwości jest wysyłane do pinu źródłowego. (Ponadto żądanie właściwości dla węzła typu SUM lub MUX jest wysyłane do źródłowego pinu.)

W przypadku tych konwencji można jednoznacznie zidentyfikować określony węzeł na określonej ścieżce danych.

Aby uzyskać informacje o używaniu interfejsu API miksera do przechodzenia przez węzły w ścieżce danych, zobacz Konwersję topologii strumieniowania jądra na interfejs API miksera audio.