Freigeben über


befehl MCI_STATUS

Hinweis

Bias-freie Kommunikation Microsoft unterstützt eine vielfältige und inklusionäre Umgebung. In diesem Dokument gibt es Verweise auf das Wort "Slave". Im Microsoft Style Guide for Bias-Free Communications wird dies als ausgrenzender Begriff erkannt. Diese Formulierung wird verwendet, da es sich derzeit um die Formulierung handelt, die in den Befehlen verwendet wird. Aus Gründen der Konsistenz enthält dieses Dokument dieses Wort. Wenn dieses Wort in den Befehlen geändert wird, korrigieren wir dieses Dokument so, dass es ausgerichtet ist.

Der befehl MCI_STATUS ruft Informationen zu einem MCI-Gerät ab. Alle Geräte erkennen diesen Befehl. Informationen werden im dwReturn-Element der struktur zurückgegeben, die durch den lpStatus-Parameter identifiziert wird.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_STATUS, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_STATUS_PARMS) lpStatus
);

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.

lpStatus

Zeiger auf eine MCI_STATUS_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 Standard- und befehlsspezifischen Flags gelten für alle Geräte, die MCI_STATUS unterstützen:

MCI_STATUS_ITEM

Gibt an, dass das dwItem-Element der durch lpStatus identifizierten Struktur eine Konstante enthält, die angibt, welches status Element abgerufen werden soll. Die folgenden Konstanten definieren, welches status Element im dwReturn-Element der Struktur zurückgegeben werden soll:

MCI_STATUS_CURRENT_TRACK

Der dwReturn-Member ist auf die aktuelle Spurnummer festgelegt. MCI verwendet fortlaufende Spurnummern.

MCI_STATUS_LENGTH

Das dwReturn-Element ist auf die Gesamtlänge der Medien festgelegt.

MCI_STATUS_MODE

Der dwReturn-Member ist auf den aktuellen Modus des Geräts festgelegt. Die Modi umfassen Folgendes:

  • MCI_MODE_NOT_READY
  • MCI_MODE_PAUSE
  • MCI_MODE_PLAY
  • MCI_MODE_STOP
  • MCI_MODE_OPEN
  • MCI_MODE_RECORD
  • MCI_MODE_SEEK

MCI_STATUS_NUMBER_OF_TRACKS

Das dwReturn-Element ist auf die Gesamtanzahl der abspielbaren Spuren festgelegt.

MCI_STATUS_POSITION

Das dwReturn-Element ist auf die aktuelle Position festgelegt.

MCI_STATUS_READY

Das dwReturn-Element ist auf TRUE festgelegt, wenn das Gerät bereit ist. Andernfalls ist sie auf FALSE festgelegt.

MCI_STATUS_TIME_FORMAT

Der dwReturn-Member ist auf das aktuelle Zeitformat des Geräts festgelegt. Die Zeitformate umfassen:

  • MCI_FORMAT_BYTES
  • MCI_FORMAT_FRAMES
  • MCI_FORMAT_HMS
  • MCI_FORMAT_MILLISECONDS
  • MCI_FORMAT_MSF
  • MCI_FORMAT_SAMPLES
  • MCI_FORMAT_TMSF

MCI_STATUS_START

Ruft die Startposition des Mediums ab. Um die Startposition abzurufen, kombinieren Sie dieses Flag mit MCI_STATUS_ITEM, und legen Sie das dwItem-Element der von lpStatus identifizierten Struktur auf MCI_STATUS_POSITION fest.

MCI_TRACK

Gibt an, dass ein status Track-Parameter im dwTrack-Member der durch lpStatus identifizierten Struktur enthalten ist. Sie müssen dieses Flag mit den MCI_STATUS_POSITION oder MCI_STATUS_LENGTH Konstanten verwenden. Bei Verwendung mit MCI_STATUS_POSITION ruft MCI_TRACK die Startposition der angegebenen Spur ab. Bei Verwendung mit MCI_STATUS_LENGTH erhält MCI_TRACK die Länge des angegebenen Tracks. MCI verwendet fortlaufende Spurnummern.

Die folgenden zusätzlichen Flags werden mit dem Gerätetyp cdaudio verwendet. Diese Konstanten werden im dwItem-Element der Struktur verwendet, auf die der lpStatus-Parameter verweist, wenn MCI_STATUS_ITEM für den dwFlags-Parameter angegeben wird.

MCI_CDA_STATUS_TYPE_TRACK

Der dwReturn-Member ist auf einen der folgenden Werte festgelegt:

  • MCI_CDA_TRACK_AUDIO
  • MCI_CDA_TRACK_OTHER

Um dieses Flag zu verwenden, muss das MCI_TRACK-Flag festgelegt werden, und das dwTrack-Element der durch lpStatus identifizierten Struktur muss eine gültige Spurnummer enthalten.

MCI_STATUS_MEDIA_PRESENT

Das dwReturn-Element wird auf TRUE festgelegt, wenn das Medium in das Gerät eingefügt wird. Andernfalls ist sie auf FALSE festgelegt.

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

MCI_DGV_STATUS_DISKSPACE

Das lpstrDrive-Element der durch lpStatus identifizierten Struktur gibt ein Laufwerk oder in einigen Implementierungen einen Pfad an. Der befehl MCI_STATUS gibt die ungefähre Menge des Speicherplatzes zurück, die vom Befehl MCI_RESERVE im dwReturn-Element der durch lpStatus identifizierten Struktur abgerufen werden kann. Der Speicherplatz wird in Einheiten des aktuellen Zeitformats gemessen.

MCI_DGV_STATUS_INPUT

Die Konstante, die vom dwItem-Member der durch lpStatus identifizierten Struktur angegeben wird, gilt für die Eingabe.

MCI_DGV_STATUS_LEFT

Die vom dwItem-Member der durch lpStatus identifizierte Struktur angegebene Konstante gilt für den linken Audiokanal.

MCI_DGV_STATUS_NOMINAL

Die Konstante, die vom dwItem-Member der durch lpStatus identifizierten Struktur angegeben wird, fordert den Nominalwert anstelle des aktuellen Werts an.

MCI_DGV_STATUS_OUTPUT

Die Konstante, die vom dwItem-Member der durch lpStatus identifizierten Struktur angegeben wird, gilt für die Ausgabe.

MCI_DGV_STATUS_RECORD

Die für das Flag "MCI_DGV_STATUS_FRAME_RATE" zurückgegebene Bildrate ist die für die Komprimierung verwendete Rate.

MCI_DGV_STATUS_REFERENCE

Das dwReturn-Element der durch lpStatus identifizierten Struktur gibt das nächstgelegene Keyframebild zurück, das dem im dwReference-Member angegebenen Frame vorangeht.

MCI_DGV_STATUS_RIGHT

Die Konstante, die vom dwItem-Member der durch lpStatus identifizierten Struktur angegeben wird, gilt für den richtigen Audiokanal.

Die folgenden Konstanten werden mit dem digitalvideo-Gerätetyp im dwItem-Member der Struktur verwendet, auf die der lpStatus-Parameter verweist, wenn MCI_STATUS_ITEM für den dwFlags-Parameter angegeben wird.

MCI_AVI_STATUS_AUDIO_BREAKS

Der dwReturn-Member gibt die Häufigkeit zurück, wie oft der Audioteil der letzten AVI-Sequenz unterbrochen wurde. Das System zählt eine Audiounterbrechung, wenn es versucht, Audiodaten in den Gerätetreiber zu schreiben, und erkennt, dass der Treiber bereits alle verfügbaren Daten wiedergegeben hat. Dieses Flag wird nur vom MCIAVI-Digitalvideotreiber erkannt.

MCI_AVI_STATUS_FRAMES_SKIPPED

Das dwReturn-Element gibt die Anzahl der Frames zurück, die nicht gezeichnet wurden, als die letzte AVI-Sequenz wiedergegeben wurde. Dieses Flag wird nur vom MCIAVI-Digitalvideotreiber erkannt.

MCI_AVI_STATUS_LAST_PLAY_SPEED

Das dwReturn-Element gibt einen Wert zurück, der angibt, wie sehr die tatsächliche Wiedergabezeit der letzten AVI-Sequenz mit der Zielspielzeit übereinstimmte. Der Wert 1000 gibt an, dass die Zielzeit und die tatsächliche Zeit identisch waren. Ein Wert von 2000 würde beispielsweise darauf hinweisen, dass die WIEDERGABE der AVI-Sequenz doppelt so lange dauerte, wie sie sollte. Dieses Flag wird nur vom MCIAVI-Digitalvideotreiber erkannt.

MCI_DGV_STATUS_AUDIO

Der dwReturn-Member gibt MCI_ON oder MCI_OFF zurück, abhängig von der neuesten MCI_SET_AUDIO-Option für den befehl MCI_SET . Es gibt MCI_ON zurück, wenn einer oder beide Lautsprecher aktiviert sind, und MCI_OFF andernfalls.

MCI_DGV_STATUS_AUDIO_INPUT

Der dwReturn-Member gibt den ungefähren momentanen Audiopegel des analogen Audiosignals zurück. Ein Wert größer als 1.000 impliziert, dass eine Abschneideverzerrung vorliegt. Einige Geräte können diesen Wert nur während der Audioaufzeichnung ermitteln. Diesem status-Wert ist kein MCI_SET oder MCI_SETAUDIO-Befehl zugeordnet. Dieser Wert hängt mit dem Waveform-Audio-Befehl MCI_WAVE_STATUS_LEVEL zusammen, normalisiert sich jedoch anders als der Befehl waveform-audio.

MCI_DGV_STATUS_AUDIO_RECORD

Das dwReturn-Element gibt MCI_ON oder MCI_OFF zurück, die den Zustand widerspiegeln, der durch das MCI_DGV_SETAUDIO_RECORD Flag des MCI_SETAUDIO-Befehls festgelegt ist.

MCI_DGV_STATUS_AUDIO_SOURCE

Der dwReturn-Member gibt die aktuelle Audiodigisiererquelle zurück:

MCI_DGV_SETAUDIO_AVERAGE

Gibt den Durchschnitt der linken und rechten Audiokanäle an.

MCI_DGV_SETAUDIO_LEFT

Gibt den linken Audiokanal an.

MCI_DGV_SETAUDIO_RIGHT

Gibt den richtigen Audiokanal an.

MCI_DGV_SETAUDIO_STEREO

Gibt Stereo an.

MCI_DGV_STATUS_AUDIO_STREAM

Der dwReturn-Member gibt die aktuelle Audiostreamnummer zurück.

MCI_DGV_STATUS_AVGBYTESPERSEC

Das dwReturn-Element gibt die durchschnittliche Anzahl von Bytes pro Sekunde zurück, die für die Aufzeichnung verwendet werden.

MCI_DGV_STATUS_BASS

Das dwReturn-Element gibt den aktuellen Audio-Basspegel zurück. Verwenden Sie MCI_DGV_STATUS_NOMINAL mit diesem Flag, um die Nominalebene zu erhalten.

MCI_DGV_STATUS_BITSPERPEL

Das dwReturn-Element gibt die Anzahl der Bits pro Pixel zurück, die zum Speichern von erfassten oder aufgezeichneten Daten verwendet werden.

MCI_DGV_STATUS_BITSPERSAMPLE

Der dwReturn-Member gibt die Anzahl der Bits pro Beispiel zurück, die das Gerät für die Aufzeichnung verwendet. Dies gilt nur für Geräte, die das PCM-Format unterstützen.

MCI_DGV_STATUS_BLOCKALIGN

Das dwReturn-Element gibt die Ausrichtung von Datenblöcken relativ zum Beginn der Eingabewellenform zurück.

MCI_DGV_STATUS_BRIGHTNESS

Der dwReturn-Member gibt die aktuelle Videohelligkeit zurück. Verwenden Sie MCI_DGV_STATUS_NOMINAL mit diesem Flag, um die Nominalebene zu erhalten.

MCI_DGV_STATUS_COLOR

Das dwReturn-Element gibt die aktuelle Farbebene zurück. Verwenden Sie MCI_DGV_STATUS_NOMINAL mit diesem Flag, um die Nominalebene zu erhalten.

MCI_DGV_STATUS_CONTRAST

Das dwReturn-Element gibt die aktuelle Kontraststufe zurück. Verwenden Sie MCI_DGV_STATUS_NOMINAL mit diesem Flag, um die Nominalebene zu erhalten.

MCI_DGV_STATUS_FILEFORMAT

Das dwReturn-Element gibt das aktuelle Dateiformat zum Aufzeichnen oder Speichern zurück.

MCI_DGV_STATUS_FILE_MODE

Der dwReturn-Member gibt den Zustand des Dateivorgangs zurück:

MCI_DGV_FILE_MODE_EDITING

Wird während Ausschneiden, Kopieren, Löschen, Einfügen und Rückgängigmachen zurückgegeben.

MCI_DGV_FILE_MODE_IDLE

Wird zurückgegeben, wenn die Datei für den nächsten Vorgang bereit ist.

MCI_DGV_FILE_MODE_LOADING

Wird zurückgegeben, während die Datei geladen wird.

MCI_DGV_FILE_MODE_SAVING

Wird zurückgegeben, während die Datei gespeichert wird.

MCI_DGV_STATUS_FILE_COMPLETION

Der dwReturn-Member gibt den geschätzten Prozentsatz zurück, den ein Lade-, Speicher-, Erfassungs-, Ausschneiden-, Kopier-, Lösch-, Einfüge- oder Rückgängigvorgang ausgeführt hat. (Anwendungen können dies verwenden, um einen visuellen Fortschrittsindikator bereitzustellen.) Dieses Flag wird nicht von allen Digitalvideogeräten unterstützt.

MCI_DGV_STATUS_FORWARD

Das dwReturn-Element gibt TRUE zurück, wenn die Geräterichtung vorwärts ist oder das Gerät nicht wiedergegeben wird.

MCI_DGV_STATUS_FRAME_RATE

Das dwReturn-Element muss mit MCI_DGV_STATUS_NOMINAL, MCI_DGV_STATUS_RECORD oder beidem verwendet werden. Bei Verwendung mit MCI_DGV_STATUS_RECORD wird die aktuelle Bildrate zurückgegeben, die für die Aufzeichnung verwendet wird. Bei Verwendung mit MCI_DGV_STATUS_RECORD und MCI_DGV_STATUS_NOMINAL wird die dem Eingangsvideosignal zugeordnete nominale Bildfrequenz zurückgegeben. Bei Verwendung mit MCI_DGV_STATUS_NOMINAL wird die der Datei zugeordnete nominale Bildrate zurückgegeben. In allen Fällen werden die Einheiten in Frames pro Sekunde multipliziert mit 1000.

MCI_DGV_STATUS_GAMMA

Das dwReturn-Element gibt den aktuellen Gammawert zurück. Verwenden Sie MCI_DGV_STATUS_NOMINAL mit diesem Flag, um die Nominalebene zu erhalten.

MCI_DGV_STATUS_HPAL

Das dwReturn-Element gibt den ASCII-Dezimalwert für das aktuelle Palettenhandle zurück. Das Handle ist im Wort mit niedriger Reihenfolge des zurückgegebenen Werts enthalten.

MCI_DGV_STATUS_HWND

Das dwReturn-Element gibt den ASCII-Dezimalwert für das aktuelle explizite oder Standardfensterhandle zurück, das diesem Gerätetreiber instance zugeordnet ist. Das Handle ist im Wort mit niedriger Reihenfolge des zurückgegebenen Werts enthalten.

MCI_DGV_STATUS_KEY_COLOR

Das dwReturn-Element gibt den aktuellen Schlüssel-Farbwert zurück.

MCI_DGV_STATUS_KEY_INDEX

Das dwReturn-Element gibt den aktuellen Schlüsselindexwert zurück.

MCI_DGV_STATUS_MONITOR

Das dwReturn-Element gibt eine Konstante zurück, die die Quelle der aktuellen Präsentation angibt. Die folgenden Konstanten werden definiert:

MCI_DGV_MONITOR_FILE

Eine Datei ist die Quelle.

MCI_DGV_MONITOR_INPUT

Die Eingabe ist die Quelle.

MCI_DGV_STATUS_MONITOR_METHOD

Das dwReturn-Element gibt eine Konstante zurück, die die für die Eingabeüberwachung verwendete Methode angibt. Die folgenden Konstanten werden definiert:

MCI_DGV_METHOD_DIRECT

Direkte Eingabeüberwachung.

MCI_DGV_METHOD_POST

Überwachung nach der Eingabe.

MCI_DGV_METHOD_PRE

Überwachung vor eingaben.

MCI_DGV_STATUS_PAUSE_MODE

Der dwReturn-Member gibt MCI_MODE_PLAY zurück, wenn das Gerät während der Wiedergabe angehalten wurde, und gibt MCI_MODE_RECORD zurück, wenn das Gerät während der Aufzeichnung angehalten wurde. Der Befehl gibt MCIERR_NONAPPLICABLE_FUNCTION als Fehlerrückgabe zurück, wenn das Gerät nicht angehalten wird.

MCI_DGV_STATUS_SAMPLESPERSECOND

Der dwReturn-Member gibt die Anzahl der aufgezeichneten Stichproben pro Sekunde zurück.

MCI_DGV_STATUS_SEEK_EXACTLY

Das dwReturn-Element gibt TRUE oder FALSE zurück, was angibt, ob das Suchformat genau festgelegt ist. (Anwendungen können dieses Format mithilfe des Befehls MCI_SET mit dem MCI_DGV_SET_SEEK_EXACTLY-Flag festlegen.)

MCI_DGV_STATUS_SHARPNESS

Das dwReturn-Element gibt die aktuelle Schärfestufe zurück. Verwenden Sie MCI_DGV_STATUS_NOMINAL mit diesem Flag, um die Nominalebene zu erhalten.

MCI_DGV_STATUS_SIZE

Das dwReturn-Element gibt die ungefähre Wiedergabedauer komprimierter Daten zurück, die der reservierte Arbeitsbereich enthält. Die Dauereinheiten befinden sich im aktuellen Zeitformat. Er gibt null zurück, wenn kein reservierter Speicherplatz vorhanden ist. Die zurückgegebene Größe ist ungefähr, da der genaue Speicherplatz für komprimierte Daten im Allgemeinen erst vorhergesagt werden kann, nachdem die Daten komprimiert wurden.

MCI_DGV_STATUS_SMPTE

Das dwReturn-Element gibt den SMPTE-Zeitcode zurück, der der aktuellen Position im Arbeitsbereich zugeordnet ist.

MCI_DGV_STATUS_SPEED

Der dwReturn-Member gibt die aktuelle Wiedergabegeschwindigkeit zurück.

MCI_DGV_STATUS_STILL_FILEFORMAT

Das dwReturn-Element gibt das aktuelle Dateiformat für den befehl MCI_CAPTURE zurück.

MCI_DGV_STATUS_TINT

Das dwReturn-Element gibt den aktuellen Videotongrad zurück. Verwenden Sie MCI_DGV_STATUS_NOMINAL mit diesem Flag, um die Nominalebene zu erhalten.

MCI_DGV_STATUS_TREBLE

Der dwReturn-Member gibt die aktuelle Audio-Höhenebene zurück. Verwenden Sie MCI_DGV_STATUS_NOMINAL mit diesem Flag, um die Nominalebene zu erhalten.

MCI_DGV_STATUS_UNSAVED

Das dwReturn-Element gibt TRUE zurück, wenn im Arbeitsbereich aufgezeichnete Daten vorhanden sind, die durch einen MCI_CLOSE-, MCI_LOAD-, MCI_RECORD-, MCI_RESERVE-, MCI_CUT-, MCI_DELETE- oder MCI_PASTE-Befehl verloren gehen können. Andernfalls gibt das Element FALSE zurück.

MCI_DGV_STATUS_VIDEO

Das dwReturn-Element gibt MCI_ON zurück, wenn Video aktiviert ist oder MCI_OFF, wenn es deaktiviert ist.

MCI_DGV_STATUS_VIDEO_RECORD

Der dwReturn-Member gibt MCI_ON oder MCI_OFF zurück, was den Zustand widerspiegelt, der durch das MCI_DGV_SETVIDEO_RECORD Flag des MCI_SETVIDEO-Befehls festgelegt wird.

MCI_DGV_STATUS_VIDEO_SOURCE

Das dwReturn-Element gibt eine Konstante zurück, die den Typ der Videoquelle angibt, die vom MCI_DGV_SETVIDEO_SOURCE Flag des befehls MCI_SETVIDEO festgelegt wird.

MCI_DGV_STATUS_VIDEO_SRC_NUM

Das dwReturn-Element gibt die Zahl innerhalb seines Typs der derzeit aktiven Videoeingabequelle zurück.

MCI_DGV_STATUS_VIDEO_STREAM

Das dwReturn-Element gibt die aktuelle Videostreamnummer zurück.

MCI_DGV_STATUS_VOLUME

Der dwReturn-Member gibt den Mittelwert der Lautstärke an die linken und rechten Lautsprecher zurück. Verwenden Sie MCI_DGV_STATUS_NOMINAL mit diesem Flag, um die Nominalebene zu erhalten.

MCI_DGV_STATUS_WINDOW_VISIBLE

Das dwReturn-Element gibt TRUE zurück, wenn das Fenster nicht ausgeblendet ist.

MCI_DGV_STATUS_WINDOW_MINIMIZED

Das dwReturn-Element gibt TRUE zurück, wenn das Fenster minimiert wird.

MCI_DGV_STATUS_WINDOW_MAXIMIZED

Das dwReturn-Element gibt TRUE zurück, wenn das Fenster maximiert ist.

MCI_STATUS_MEDIA_PRESENT

Das dwReturn-Element gibt TRUE zurück.

Bei Digitalvideogeräten verweist der lpStatus-Parameter auf eine MCI_DGV_STATUS_PARMS-Struktur .

Die folgenden zusätzlichen Flags werden mit dem Sequencer-Gerätetyp verwendet. Diese Konstanten werden im dwItem-Element der Struktur verwendet, auf die der lpStatus-Parameter verweist, wenn MCI_STATUS_ITEM für den dwFlags-Parameter angegeben wird.

MCI_SEQ_STATUS_DIVTYPE

Der dwReturn-Member ist auf einen der folgenden Werte festgelegt, die den aktuellen Divisionstyp einer Sequenz angeben:

  • MCI_SEQ_DIV_PPQN
  • MCI_SEQ_DIV_SMPTE_24
  • MCI_SEQ_DIV_SMPTE_25
  • MCI_SEQ_DIV_SMPTE_30
  • MCI_SEQ_DIV_SMPTE_30DROP

MCI_SEQ_STATUS_MASTER

Das dwReturn-Element ist auf den Synchronisierungstyp festgelegt, der für master Vorgang verwendet wird.

MCI_SEQ_STATUS_OFFSET

Das dwReturn-Element ist auf den aktuellen SMPTE-Offset einer Sequenz festgelegt.

MCI_SEQ_STATUS_PORT

Das dwReturn-Element wird auf den MIDI-Gerätebezeichner für den aktuellen Port festgelegt, der von der Sequenz verwendet wird.

MCI_SEQ_STATUS_SLAVE

Das dwReturn-Element ist auf den Synchronisierungstyp festgelegt, der für den untergeordneten Vorgang verwendet wird.

MCI_SEQ_STATUS_TEMPO

Das dwReturn-Element wird auf das aktuelle Tempo einer MIDI-Sequenz in Takten pro Minute für PPQN-Dateien oder auf Frames pro Sekunde für SMPTE-Dateien festgelegt.

MCI_STATUS_MEDIA_PRESENT

Das dwReturn-Element wird auf TRUE festgelegt, wenn das Medium in das Gerät eingefügt wird. Andernfalls ist sie auf FALSE festgelegt.

Die folgenden zusätzlichen Flags werden mit dem Vcr-Gerätetyp verwendet. Diese Konstanten werden im dwItem-Element der Struktur verwendet, auf die der lpStatus-Parameter verweist, wenn MCI_STATUS_ITEM für den dwFlags-Parameter angegeben wird.

MCI_STATUS_MEDIA_PRESENT

Das dwReturn-Element wird auf TRUE festgelegt, wenn das Medium in das Gerät eingefügt wird. Andernfalls ist sie auf FALSE festgelegt.

MCI_VCR_STATUS_ASSEMBLE_RECORD

Das dwReturn-Element ist auf TRUE festgelegt, wenn der Assemblermodus aktiviert ist. Andernfalls ist sie auf FALSE festgelegt.

MCI_VCR_STATUS_AUDIO_MONITOR

Das dwReturn-Element ist auf eine Konstante festgelegt, die den aktuell ausgewählten Audiomonitortyp angibt.

MCI_VCR_STATUS_AUDIO_MONITOR_NUMBER

Das dwReturn-Element ist auf die Nummer des aktuell ausgewählten Audiomonitortyps festgelegt.

MCI_VCR_STATUS_AUDIO_RECORD

Der dwReturn-Member ist auf TRUE festgelegt, wenn audio aufgezeichnet wird, wenn der nächste Datensatzbefehl angegeben wird. Andernfalls ist sie auf FALSE festgelegt. Wenn Sie im dwFlags-Parameter dieses Befehls MCI_TRACK angeben, enthält dwTrack den Track, für den diese Anfrage gilt.

MCI_VCR_STATUS_AUDIO_SOURCE

Das dwReturn-Element ist auf eine Konstante festgelegt, die den aktuellen Audioquellentyp angibt.

MCI_VCR_STATUS_AUDIO_SOURCE_NUMBER

Das dwReturn-Element ist auf die Nummer des aktuell ausgewählten Audioquellentyps festgelegt.

MCI_VCR_STATUS_CLOCK

Das dwReturn-Element wird auf den aktuellen Uhrwert in Gesamttaktschritten festgelegt.

MCI_VCR_STATUS_CLOCK_ID

Das dwReturn-Element wird auf eine Zahl festgelegt, die die verwendete Uhr eindeutig beschreibt.

MCI_VCR_STATUS_COUNTER_FORMAT

Der dwReturn-Member wird auf eine Konstante festgelegt, die das aktuelle Zählerformat beschreibt. Weitere Informationen finden Sie im MCI_SET_TIME_FORMAT-Flag des Befehls MCI_SET .

MCI_VCR_STATUS_COUNTER_RESOLUTION

Der dwReturn-Member wird auf eine Konstante festgelegt, die die Auflösung des Zählers beschreibt, und ist einer der folgenden Werte:

  • MCI_VCR_COUNTER_RES_FRAMES: Der Zähler verfügt über eine Auflösung von Frames.
  • MCI_VCR_COUNTER_RES_SECONDS: Der Zähler hat eine Auflösung von Sekunden.
  • MCI_VCR_STATUS_COUNTER_VALUE: Der dwReturn-Member wird auf den aktuellen Zählerwert im aktuellen Zählerzeitformat festgelegt.

MCI_VCR_STATUS_FRAME_RATE

Das dwReturn-Element ist auf die aktuelle native Bildfrequenz des Geräts festgelegt.

MCI_VCR_STATUS_INDEX

Der dwReturn-Member ist auf eine Konstante festgelegt, die den aktuellen Inhalt der Bildschirmanzeige beschreibt, und ist einer der folgenden:

  • MCI_VCR_INDEX_COUNTER
  • MCI_VCR_INDEX_DATE
  • MCI_VCR_INDEX_TIME
  • MCI_VCR_INDEX_TIMECODE

MCI_VCR_STATUS_INDEX_ON

Der dwReturn-Member ist auf TRUE festgelegt, wenn die Bildschirmanzeige aktiviert ist. Andernfalls wird er auf FALSE festgelegt.

MCI_VCR_STATUS_MEDIA_TYPE

Das dwReturn-Element ist auf einen der folgenden Elemente festgelegt:

  • MCI_VCR_MEDIA_8MM
  • MCI_VCR_MEDIA_HI8
  • MCI_VCR_MEDIA_VHS
  • MCI_VCR_MEDIA_SVHS
  • MCI_VCR_MEDIA_BETA
  • MCI_VCR_MEDIA_EDBETA
  • MCI_VCR_MEDIA_OTHER

MCI_VCR_STATUS_NUMBER

Das dwNumber-Element wird auf die Logical-Tuner-Nummer festgelegt, wenn Sie dieses Flag mit dem flag MCI_VCR_STATUS_TUNER_CHANNEL verwenden.

MCI_VCR_STATUS_NUMBER_OF_AUDIO_TRACKS

Der dwReturn-Member ist auf die Anzahl der Audiospuren festgelegt, die unabhängig voneinander ausgewählt werden können.

MCI_VCR_STATUS_NUMBER_OF_VIDEO_TRACKS

Das dwReturn-Element ist auf die Anzahl der Videospuren festgelegt, die unabhängig voneinander ausgewählt werden können.

MCI_VCR_STATUS_PAUSE_TIMEOUT

Der dwReturn-Member wird auf die maximale Dauer eines Pause-Befehls in Millisekunden festgelegt. Der Rückgabewert 0 (null) gibt an, dass kein Timeout auftritt.

MCI_VCR_STATUS_PLAY_FORMAT

Das dwReturn-Element ist auf einen der folgenden Elemente festgelegt:

  • MCI_VCR_FORMAT_EP
  • MCI_VCR_FORMAT_LP
  • MCI_VCR_FORMAT_OTHER
  • MCI_VCR_FORMAT_SP

MCI_VCR_STATUS_POSTROLL_DURATION

Der dwReturn-Member ist auf die Länge des Videobands festgelegt, das nach der Stelle, an der es beendet wurde, im aktuellen Zeitformat wiedergegeben wird. Dies ist erforderlich, um den VcR-Bandtransport von einem Stopp- oder Pause-Befehl zu bremsen.

MCI_VCR_STATUS_POWER_ON

Der dwReturn-Member wird auf TRUE festgelegt, wenn der Strom eingeschaltet ist. Andernfalls wird er auf FALSE festgelegt.

MCI_VCR_STATUS_PREROLL_DURATION

Das dwReturn-Element wird im aktuellen Zeitformat auf die Länge des Videobands festgelegt, das vor der Stelle wiedergegeben wird, an der es gestartet wurde. Dies ist erforderlich, um die VcR-Ausgabe zu stabilisieren.

MCI_VCR_STATUS_RECORD_FORMAT

Das dwReturn-Element ist auf einen der folgenden Elemente festgelegt:

  • MCI_VCR_FORMAT_EP
  • MCI_VCR_FORMAT_LP
  • MCI_VCR_FORMAT_OTHER
  • MCI_VCR_FORMAT_SP

MCI_VCR_STATUS_SPEED

Der dwReturn-Member ist auf die aktuelle Geschwindigkeit festgelegt. Weitere Informationen finden Sie im MCI_VCR_SET_SPEED-Flag des Befehls MCI_SET .

MCI_VCR_STATUS_TIME_MODE

Das dwReturn-Element ist auf einen der folgenden Elemente festgelegt:

  • MCI_VCR_TIME_COUNTER
  • MCI_VCR_TIME_DETECT
  • MCI_VCR_TIME_TIMECODE

Weitere Informationen finden Sie im MCI_VCR_SET_TIME_MODE-Flag des Befehls MCI_SET .

MCI_VCR_STATUS_TIME_TYPE

Der dwReturn-Member ist auf eine Konstante festgelegt, die den aktuellen verwendeten Zeittyp beschreibt (verwendet von Wiedergabe, Aufzeichnung, Suche usw.), und ist einer der folgenden:

MCI_VCR_TIME_COUNTER

Der Zähler wird verwendet.

MCI_VCR_TIME_TIMECODE

Timecode wird verwendet.

MCI_VCR_STATUS_TIMECODE_PRESENT

Das dwReturn-Element wird auf TRUE festgelegt, wenn der Timecode an der aktuellen Position im Inhalt vorhanden ist. Andernfalls wird er auf FALSE festgelegt.

MCI_VCR_STATUS_TIMECODE_RECORD

Der dwReturn-Member wird auf TRUE festgelegt, wenn der Timecode aufgezeichnet wird, wenn der nächste Datensatzbefehl angegeben wird. Andernfalls wird er auf FALSE festgelegt.

MCI_VCR_STATUS_TIMECODE_TYPE

Der dwReturn-Member ist auf eine Konstante festgelegt, die den Typ des Timecodes beschreibt, der direkt vom Gerät unterstützt wird, und ist einer der folgenden:

  • MCI_VCR_TIMECODE_TYPE_NONE: Dieses Gerät verwendet keinen Timecode.
  • MCI_VCR_TIMECODE_TYPE_OTHER: Dieses Gerät verwendet einen nicht angegebenen Timecode.
  • MCI_VCR_TIMECODE_TYPE_SMPTE: Dieses Gerät verwendet SMPTE-Timecode.
  • MCI_VCR_TIMECODE_TYPE_SMPTE_DROP: Dieses Gerät verwendet den SMPTE-Drop-Timecode.

MCI_VCR_STATUS_TUNER_CHANNEL

Das dwReturn-Element wird auf die aktuelle Kanalnummer festgelegt. Wenn Sie MCI_VCR_STATUS_NUMBER im dwFlags-Parameter dieses Befehls angeben, enthält dwNumber die Logische Tunernummer, für die dieser Befehl gilt.

MCI_VCR_STATUS_VIDEO_MONITOR

Der dwReturn-Member ist auf eine Konstante festgelegt, die den aktuell ausgewählten Videomonitortyp angibt.

MCI_VCR_STATUS_VIDEO_MONITOR_NUMBER

Der dwReturn-Member ist auf die Nummer des derzeit ausgewählten Videomonitortyps festgelegt.

MCI_VCR_STATUS_VIDEO_RECORD

Das dwReturn-Element ist auf TRUE festgelegt, wenn das Video aufgezeichnet wird, wenn der nächste Datensatzbefehl angegeben wird. Andernfalls wird er auf FALSE festgelegt. Wenn Sie MCI_TRACK im dwFlags-Parameter dieses Befehls angeben, enthält dwTrack den Track, für den sich diese Abfrage bezieht.

MCI_VCR_STATUS_VIDEO_SOURCE

Der dwReturn-Member ist auf eine Konstante festgelegt, die den aktuell ausgewählten Videoquellentyp angibt.

MCI_VCR_STATUS_VIDEO_SOURCE_NUMBER

Der dwReturn-Member ist auf die Nummer des derzeit ausgewählten Videoquellentyps festgelegt.

MCI_VCR_STATUS_WRITE_PROTECTED

Der dwReturn-Member wird auf TRUE festgelegt, wenn das Medium schreibgeschützt ist. Andernfalls wird er auf FALSE festgelegt.

Bei VcR-Geräten verweist der parameter lpStatus auf eine MCI_VCR_STATUS_PARMS-Struktur .

Die Verwendung des MCI_STATUS_LENGTH-Flags, um die Länge der Medien zu bestimmen, gibt für VcR-Geräte immer 2 Stunden zurück, es sei denn, die Länge wurde explizit mithilfe des Befehls MCI_SET geändert.

Die folgenden zusätzlichen Flags werden mit dem Überlagerungsgerätetyp verwendet. Diese Konstanten werden im dwItem-Element der Struktur verwendet, auf die der lpStatus-Parameter verweist, wenn für den dwFlags-Parameter MCI_STATUS_ITEM angegeben wird.

MCI_OVLY_STATUS_HWND

Der dwReturn-Member wird auf das Handle des Fensters festgelegt, das dem Videoüberlagerungsgerät zugeordnet ist.

MCI_OVLY_STATUS_STRETCH

Der dwReturn-Member wird auf TRUE festgelegt, wenn das Stretching aktiviert ist. Andernfalls wird er auf FALSE festgelegt.

MCI_STATUS_MEDIA_PRESENT

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Medium in das Gerät eingefügt wird. Andernfalls wird er auf FALSE festgelegt.

Die folgenden zusätzlichen Flags werden mit dem Videodisc-Gerätetyp verwendet. Diese Konstanten werden im dwItem-Element der Struktur verwendet, auf die der lpStatus-Parameter verweist, wenn für den dwFlags-Parameter MCI_STATUS_ITEM angegeben wird.

MCI_STATUS_MEDIA_PRESENT

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Medium in das Gerät eingefügt wird. Andernfalls wird er auf FALSE festgelegt.

MCI_STATUS_MODE

Das dwReturn-Element wird auf den aktuellen Modus des Geräts festgelegt. Videodisc-Geräte können die MCI_VD_MODE_PARK Konstante zurückgeben, zusätzlich zu den Konstanten, die jedes Gerät zurückgeben kann, wie mit dem dwFlags-Parameter dokumentiert.

MCI_VD_STATUS_DISC_SIZE

Der dwReturn-Member wird auf die Größe des geladenen Datenträgers in Zoll (8 oder 12) festgelegt.

MCI_VD_STATUS_FORWARD

Das dwReturn-Element wird auf TRUE festgelegt, wenn vorwärts gespielt wird. Andernfalls wird er auf FALSE festgelegt.

Das MCI-Videodisc-Gerät unterstützt dieses Flag nicht.

MCI_VD_STATUS_MEDIA_TYPE

Der dwReturn-Member ist auf den Medientyp des eingefügten Mediums festgelegt. Die folgenden Medientypen können zurückgegeben werden:

MCI_VD_MEDIA_CAV

MCI_VD_MEDIA_CLV

MCI_VD_MEDIA_OTHER

MCI_VD_STATUS_SIDE

Der dwReturn-Member ist auf 1 oder 2 festgelegt, um anzugeben, welche Seite des Datenträgers geladen wird. Dieses Flag wird nicht von allen videodisc-Geräten unterstützt.

MCI_VD_STATUS_SPEED

Das dwReturn-Element ist auf die Wiedergabegeschwindigkeit in Bildern pro Sekunde festgelegt. Der MCIPIONR. Der DRV-Gerätetreiber gibt MCIERR_UNSUPPORTED_FUNCTION zurück.

Die folgenden zusätzlichen Flags werden mit dem Waveaudio-Gerätetyp verwendet. Diese Konstanten werden im dwItem-Element der Struktur verwendet, auf die der lpStatus-Parameter verweist, wenn für den dwFlags-Parameter MCI_STATUS_ITEM angegeben wird.

MCI_WAVE_FORMATTAG

Das dwReturn-Element wird auf das aktuelle Formattag festgelegt, das zum Wiedergeben, Aufzeichnen und Speichern verwendet wird.

MCI_WAVE_INPUT

Der dwReturn-Member ist auf das Welleneingabegerät festgelegt, das für die Aufzeichnung verwendet wird. Wenn kein Gerät verwendet wird und kein Gerät explizit festgelegt wurde, wird die Fehlerrückgabe MCIERR_WAVE_INPUTUNSPECIFIED.

MCI_WAVE_OUTPUT

Der dwReturn-Member ist auf das Wellenausgabegerät festgelegt, das für die Wiedergabe verwendet wird. Wenn kein Gerät verwendet wird und kein Gerät explizit festgelegt wurde, wird die Fehlerrückgabe MCIERR_WAVE_OUTPUTUNSPECIFIED.

MCI_WAVE_STATUS_AVGBYTESPERSEC

Das dwReturn-Element wird auf die aktuellen Bytes pro Sekunde festgelegt, die zum Wiedergeben, Aufzeichnen und Speichern verwendet werden.

MCI_WAVE_STATUS_BITSPERSAMPLE

Der dwReturn-Member ist auf die aktuellen Bits pro Beispiel festgelegt, die zum Wiedergeben, Aufzeichnen und Speichern von PCM-formatierten Daten verwendet werden.

MCI_WAVE_STATUS_BLOCKALIGN

Der dwReturn-Member ist auf die aktuelle Blockausrichtung festgelegt, die zum Wiedergeben, Aufzeichnen und Speichern verwendet wird.

MCI_WAVE_STATUS_CHANNELS

Das dwReturn-Element ist auf die aktuelle Kanalanzahl festgelegt, die zum Wiedergeben, Aufzeichnen und Speichern verwendet wird.

MCI_WAVE_STATUS_LEVEL

Das dwReturn-Element wird auf die aktuelle Aufnahme- oder Wiedergabeebene von PCM-formatierten Daten festgelegt. Der Wert wird je nach verwendeter Stichprobengröße als 8- oder 16-Bit-Wert zurückgegeben. Die rechte oder mono-Kanalebene wird im Wort mit niedriger Reihenfolge zurückgegeben. Die linke Kanalebene wird im Wort mit hoher Reihenfolge zurückgegeben.

MCI_WAVE_STATUS_SAMPLESPERSEC

Der dwReturn-Member ist auf die aktuellen Stichproben pro Sekunde festgelegt, die zum Wiedergeben, Aufzeichnen und Speichern verwendet werden.

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

MCI_CUT

MCI_DELETE

MCI_PASTE

MCI_RESERVE

MCI_SET

play

record

Suchen