befehl MCI_CUE

Der MCI_CUE-Befehl gibt Hinweise auf ein Gerät, sodass die Wiedergabe oder Aufzeichnung mit minimaler Verzögerung beginnt. Digital-Video-, Video- und Waveform-Audiogeräte erkennen diesen Befehl.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_CUE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpCue
);

Parameter

wDeviceID

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

dwFlags

MCI_NOTIFY, MCI_WAIT oder für Digitalvideo- und Videorekordergeräte MCI_TEST. Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.

lpCue

Zeiger auf eine MCI_GENERIC_PARMS-Struktur . (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.

Bemerkungen

Die folgenden zusätzlichen Flags werden mit dem Gerätetyp digitalvideo verwendet:

MCI_DGV_CUE_INPUT

Ein digital-video-instance sollte sich auf die Aufzeichnung vorbereiten. Wenn die Anwendung keinen reservierten Speicherplatz hat, reserviert das Gerät den Speicherplatz unter Verwendung der Standardparameter. Die Anwendung kann dieses Flag weglassen, wenn die aktuelle Präsentationsquelle bereits die externe Eingabe ist. (Dieses Flag hat keine Auswirkungen auf die Auswahl der Präsentationsquelle.)

MCI_DGV_CUE_NOSHOW

Ein digital-video-instance sollte sich auf die Wiedergabe des mit dem Befehl angegebenen Frames vorbereiten, ohne ihn anzuzeigen. Wenn dieses Flag angegeben wird, zeigt die Anzeige weiterhin das Bild im Framepuffer an, auch wenn der entsprechende Frame nicht die aktuelle Position ist. Wenn der Framepuffer beispielsweise das Bild aus Frame 7 enthält, zeigt das Gerät weiterhin Frame 7 an, wenn dieses Flag verwendet wird, um das Gerät an eine andere Position zu führen. Ein nachfolgender Cue-Befehl ohne dieses Flag und ohne das MCI_TO Flag zeigt den aktuellen Frame an.

MCI_DGV_CUE_OUTPUT

Ein digital-video-instance sollte sich auf die Wiedergabe vorbereiten. Wenn der Arbeitsbereich angehalten wird, erfolgt keine Positionierung. Wenn der Arbeitsbereich beendet wird, kann sich die Position in ein vorheriges Keyframe-Bild ändern. Die Anwendung kann dieses Flag weglassen, wenn die aktuelle Präsentationsquelle bereits der Arbeitsbereich ist.

MCI_TO

Eine Arbeitsbereichsposition ist im dwTo-Element der von lpCue identifizierten Struktur enthalten. Die Einheiten, die Positionswerten zugewiesen sind, werden mithilfe des MCI_SET_TIME_FORMAT-Flags des befehls MCI_SET angegeben. Dies entspricht der Suche nach einer Position, mit der Ausnahme, dass das Gerät nach dem Befehl angehalten wird.

Bei digitalen Videogeräten verweist der lpCue-Parameter auf eine MCI_DGV_CUE_PARMS-Struktur .

Die folgenden zusätzlichen Flags werden mit dem Vcr-Gerätetyp verwendet:

MCI_FROM

Das dwFrom-Element der Struktur, auf die von lpCue verwiesen wird, enthält den Startort, der im aktuellen Zeitformat angegeben ist.

MCI_TO

Das dwTo-Element der Struktur, auf die von lpCue verwiesen wird, enthält den Im aktuellen Zeitformat angegebenen Endpunkt (pausing).

MCI_VCR_CUE_INPUT

Vorbereiten der Aufzeichnung.

MCI_VCR_CUE_OUTPUT

Bereiten Sie sich auf das Spielen vor. Wenn weder MCI_VCR_CUE_INPUT noch MCI_VCR_CUE_OUTPUT angegeben ist, wird MCI_VCR_CUE_OUTPUT angenommen.

MCI_VCR_CUE_PREROLL

Führen Sie das Gerät an die aktuelle Position oder die dwFrom-Position abzüglich der Vorrolldauer. Dadurch kann sich das Gerät vorbereiten, bevor es in den Aufzeichnungs- oder Wiedergabemodus wechselt.

MCI_VCR_CUE_REVERSE

Die Richtung des nächsten Wiedergabe- oder Aufzeichnungsbefehls ist umgekehrt.

Wenn Sie hinweise für die Wiedergabe mithilfe des Befehls MCI_CUE mit dem MCI_VCR_CUE_OUTPUT-Flag verwenden, können Sie MCI_CUE abbrechen, indem Sie den Befehl MCI_PLAY mit MCI_FROM, MCI_TO oder MCI_VCR_PLAY_REVERSE ausgeben.

Wenn Sie hinweise für die Aufzeichnung mithilfe von MCI_CUE mit dem MCI_VCR_CUE_INPUT-Flag verwenden, können Sie MCI_CUE abbrechen, indem Sie den Befehl MCI_RECORD mit MCI_FROM, MCI_TO oder MCI_VCR_RECORD_INITIALIZE ausgeben.

Bei Vcr-Geräten zeigt der lpCue-Parameter auf eine MCI_VCR_CUE_PARMS-Struktur .

Die folgenden zusätzlichen Flags werden mit dem Waveaudio-Gerätetyp verwendet:

MCI_WAVE_INPUT

Es sollte ein Waveform-Audio-Eingabegerät verwendet werden.

MCI_WAVE_OUTPUT

Es sollte ein Waveform-Audioausgabegerät verwendet werden. Dies ist das Standardflag, wenn kein Flag angegeben wird.

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 (einschließlich Windows.h)

Siehe auch

MCI

MCI-Befehle