Freigeben über


Qualitätsbefehl

Der Qualitätsbefehl definiert eine benutzerdefinierte Qualitätsebene für die Komprimierung von Audio-, Video- oder Standbilddaten. Digital-Video-Geräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand wie folgt festgelegt ist.

_stprintf_s(
  lpszCommand, 
  TEXT("quality %s %s %s"), 
  lpszDeviceID, 
  lpszQuality, 
  lpszFlags
); 

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszQuality

Mindestens eins der folgenden Flags. (Eines der drei Flags "audio", "still" und "video" muss vorhanden sein.)

Wert Bedeutung
Algorithmus Ordnet die Qualitätsebene dem angegebenen Algorithmus zu. Dieser Algorithmus muss vom Gerät unterstützt werden und mit dem verwendeten Flag "audio", "still" oder "video" kompatibel sein. Wenn nicht angegeben, wird der aktuelle Algorithmus verwendet.
Audioname Gibt an, dass dieser Befehl eine "Audio"-Qualitätsebene angibt, die mit dem Namen identifiziert wird.
Dialog (dialog) Fordert an, dass das Gerät ein Dialogfeld anzeigt. Dieses Dialogfeld enthält algorithmusspezifische Felder, die intern vom Gerät verwendet werden, um die Struktur zu erstellen, die eine bestimmte Qualitätsebene beschreibt.
Handle-Handle Gibt ein Handle für eine Struktur an, die algorithmusspezifische Daten enthält, die eine bestimmte Qualitätsebene beschreiben. Die Strukturen für die Daten, auf die durch dieses Handle verwiesen wird, sind gerätespezifisch.
Stillname Gibt an, dass der Befehl eine "still"-Qualitätsebene angibt, die mit dem Namen identifiziert wird.
Videoname Gibt an, dass der Befehl eine "Video"-Qualitätsstufe angibt, die mit dem Namen identifiziert wird.

lpszFlags

Dies kann "Wait", "notify", "test" oder eine Kombination aus diesen sein. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Bemerkungen

Dieser Befehl definiert einen Zeichenfolgennamen für die Qualitätsebene, die dann in einem Setvideo "quality",setvideo "still quality" oder setaudio "quality"-Befehl verwendet werden kann, um ihn als aktuelle Video-, Still- oder Audiokomprimierungsqualität festzulegen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]

Siehe auch

MCI

MCI-Befehlszeichenfolgen

Setaudio

setvideo