befehl MCI_QUALITY
Der Befehl MCI_QUALITY definiert eine benutzerdefinierte Qualitätsstufe für die Komprimierung von Audio-, Video- oder Standbilddaten. Digital-Video-Gerä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äte-ID 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 null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.
Bemerkungen
Der für diese Qualitätsstufe definierte Name kann verwendet werden, wenn die Audio-, Video- oder Noch-Qualität mit den Befehlen MCI_SETAUDIO und MCI_SETVIDEO festgelegt wird.
Die folgenden zusätzlichen Flags gelten für Digital-Video-Gerä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.
-
MCI_QUALITY_DIALOG
-
Der Gerätetreiber sollte ein Dialogfeld zum Angeben der Qualitätsstufe anzeigen. Das Dialogfeld enthält algorithmusspezifische Felder, die intern vom Gerätetreiber verwendet werden, um eine Struktur zu erstellen, die eine bestimmte Qualitätsebene beschreibt.
-
MCI_QUALITY_HANDLE
-
Das dwHandle-Element der durch lpQuality identifizierten Struktur enthält ein Handle für eine -Struktur. Die -Struktur enthält algorithmusspezifische Daten, die die spezifische Qualitätsebene beschreiben. Das Format der Strukturen für die Algorithmen ist geräteabhängig.
-
MCI_QUALITY_ITEM
-
Eine Konstante, die den Algorithmustyp angibt, ist im dwItem-Element der durch lpQuality identifizierten Struktur enthalten.
-
MCI_QUALITY_NAME
-
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 |
|