KSPROPERTY_AUDIO_FILTER_STATE
Die KSPROPERTY_AUDIO_FILTER_STATE-Eigenschaft wird verwendet, um einen GFX-Filter nach einer Liste der unterstützten Eigenschaftensätze abzufragen. Die Liste wird in Form eines Arrays von Eigenschaftensatz-GUIDs abgerufen.
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftsdeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Ja |
Nein |
Filter |
Array von GUIDs |
Die Eigenschaftendaten (Vorgangsdaten) sind ein Array von GUIDs. Jede GUID im Array gibt einen Eigenschaftensatz an, den der Filter unterstützt.
Rückgabewert
Eine KSPROPERTY_AUDIO_FILTER_STATE-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen entsprechenden Fehler status Code zurück.
Bemerkungen
Die Größe des Arrays von GUIDs, das diese Eigenschaft zurückgibt, hängt von der Anzahl der Vom Filter unterstützten Eigenschaftensätze ab. Vor dem Abrufen des Arrays fragt ein Client zunächst die Größe des GUID-Arrays der Eigenschaft ab, indem er dem Eigenschaftenhandler des Miniporttreibers eine KSPROPERTY_AUDIO_FILTER_STATE get-property-Anforderung mit einem Null-Länge-Eigenschafts-Wert-Puffer sendet. Der Handler antwortet, indem er die erforderliche Puffergröße und den status Code STATUS_BUFFER_OVERFLOW zurückgibt. Weitere Informationen finden Sie unter Audioeigenschaftenhandler.
Mit dem Array von GUIDs aus einer KSPROPERTY_AUDIO_FILTER_STATE get-property-Anforderung kann das Betriebssystem die Eigenschaften innerhalb jedes Eigenschaftensatzes seriell abfragen. Diese Informationen ermöglichen es dem Betriebssystem, den Zustand eines GFX-Filterobjekts zum Zeitpunkt der Instanziierung des Filters wiederherzustellen und den Zustand eines GFX-Filterobjekts zu speichern, wenn der Filter zerstört wird. Beim Speichern oder Wiederherstellen des Zustands des GFX-Filters serialisiert das Betriebssystem seine Anforderungen für die Eigenschaften in jedem Eigenschaftensatz, wie unter KS-Eigenschaften beschrieben. Der Zweck für das Speichern und Wiederherstellen des Zustands des GFX-Filters besteht darin, alle Änderungen beizubehalten, die der Benutzer an den Einstellungen des Filters vorgenommen hat, und die Einstellungen über nachfolgende Instanziierungen des Filters hinweg dauerhaft zu gestalten. .
Anforderungen
Header |
Ksmedia.h (include Ksmedia.h) |