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 |
|