MCI _ QUALITY-Befehl

Der MCI QUALITY-Befehl definiert eine benutzerdefinierte Qualitätsstufe für die Komprimierung von _ Audio-, Video- oder Bilddaten. Digitalvideogeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_QUALITY, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_QUALITY_PARMS) lpQuality
);

Parameter

wDeviceID

Gerätebezeichner des MCI-Geräts, das die Befehlsnachricht empfangen soll.

Dwflags

MCI _ NOTIFY, MCI _ WAIT oder MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

lpQuality

Zeiger auf eine MCI _ DGV _ QUALITY _ PARMS-Struktur.

Rückgabewert

Gibt 0 (null) zurück, wenn erfolgreich, andernfalls ein Fehler.

Bemerkungen

Der für diese Qualitätsstufe definierte Name kann beim Festlegen der Audio-, Video- oder Noch-Qualität mit den _ MCI-Befehlen SETAUDIO und MCI _ SETVIDEO verwendet werden.

Die folgenden zusätzlichen Flags gelten für Digitalvideogeräte:

MCI _ QUALITY _ ALG

Der lpstrAlgorithm-Member der durch lpQuality identifizierten Struktur enthält eine Adresse eines Puffers, der den Namen des Algorithmus enthält. Dieser Algorithmus muss vom Gerätetreiber unterstützt werden und mit dem verwendeten Audio-, Still- oder Videodeskriptor kompatibel sein. Wenn dieses Flag weggelassen wird, wird der aktuelle Algorithmus verwendet.

DIALOGFELD _ _ "MCI-QUALITÄT"

Der Gerätetreiber sollte ein Dialogfeld zum Angeben des Qualitätsgrads anzeigen. Das Dialogfeld verfügt über algorithmusspezifische Felder, die intern vom Gerätetreiber verwendet werden, um eine Struktur zu erstellen, die einen bestimmten Qualitätsgrad beschreibt.

_MCI-QUALITÄTSHAND _ HANDLE

Der dwHandle-Member der durch lpQuality identifizierten Struktur enthält ein Handle für eine -Struktur. Die -Struktur enthält algorithmusspezifische Daten, die den spezifischen Qualitätsgrad beschreiben. Das Format der Strukturen für die Algorithmen ist geräteabhängig.

_MCI-QUALITÄTSELEMENT _

Eine Konstante, die den Typ des Algorithmus angibt, ist im dwItem-Member der struktur enthalten, die durch lpQuality identifiziert wird.

_MCI-QUALITÄTSNAME _

Der lpstrName-Member der durch lpQuality identifizierten Struktur enthält eine Adresse eines Puffers, der den Qualitätsdeskriptor enthält.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Mmsystem.h (include Windows.h)

Siehe auch

MCI

MCI-Befehle