CODECAPI_ALLSETTINGS

Die CODECAPI_ALLSETTINGS-Eigenschaft wird verwendet, um einen minidriver-generierten Datenblock hin und her zu übergeben.

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Ja	Ja	Filter	KSPROPERTY	PVOID

Der Eigenschaftswert (Vorgangsdaten) ist vom Typ PVOID, ein Zeiger auf einen Benutzermoduspuffer für den vom Minidriver generierten Datenblock.

Kommentare

Rufen Sie für eine Eigenschaft den Aufruf ab:

Wenn eine Anwendung einen Eigenschaftsaufruf mit einem Puffer der Länge null ausführt, muss der Minidriver STATUS_BUFFER_OVERFLOW zurückgeben und die erforderliche Puffergröße im Feld Irp-IoStatus.Information> angeben. Wenn der Längenpuffer nicht zero ist, muss der Minidriver STATUS_BUFFER_TOO_SMALL zurückgeben, wenn der bereitgestellte Puffer für den Datenblock zu klein ist. Andernfalls packt der Minidriver seine Einstellungen in einen Datenblock, der später wiederhergestellt werden kann.

Es liegt in der Verantwortung des Minitreibers, datenintegritätsprüfungen zu den Daten hinzuzufügen, z. B. eine eindeutige GUID, die den minidriver generierten Daten anzeigt, eine zyklische Redundanzprüfung (CRC) und eine Headerlänge.

Die zurückgegebenen Daten sollten einfach sein und nur Informationen enthalten, die zum Rekonstruieren der aktuellen Einstellungen erforderlich sind.

Anwendungen verwenden diese Eigenschaft für Rückgängigmachen auf mehreren Ebenen, die mit ihren Projekten gespeichert werden usw.

Für einen Eigenschaftssatzaufruf:

Der Minidriver muss die Integrität der Daten überprüfen und überprüfen, ob die Größe des Datenblocks unter der maximalen Datengröße liegt (z. B. alles über eine bestimmte Größe ablehnen). Außerdem müssen der CRC und die Headerlänge überprüft werden. Der Minidriver muss auch alle Änderungen zwischenspeichern, die für CODECAPI_CURRENTCHANGELIST weitergegeben werden sollen.

Anforderungen

Header: Deklariert in ksmedia.h. Schließen Sie ksmedia.h ein.

Weitere Informationen

KSPROPERTY

CODECAPI_CURRENTCHANGELIST