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	Mmsystem.h (windows.h einschließen)

Siehe auch

MCI

MCI-Befehle