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
);
-
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.)
Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.
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.
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
Header |
|