Udostępnij za pośrednictwem

Klasyfikacje poleceń MCI

  • Artykuł

[Funkcja skojarzona z tą stroną, MCI, jest starszą funkcją. Został zastąpiony przez MediaPlayer. MediaPlayer został zoptymalizowany pod kątem systemów Windows 10 i Windows 11. Firma Microsoft zdecydowanie zaleca, aby nowy kod używał MediaPlayer zamiast MCI, jeśli jest to możliwe. Firma Microsoft sugeruje, że istniejący kod, który używa starszych interfejsów API, należy przepisać go do korzystania z nowych interfejsów API, jeśli to możliwe.]

Interfejs MCI definiuje cztery klasyfikacje poleceń: system, wymagany, podstawowy i rozszerzony. Poniższa lista zawiera opis tych klasyfikacji poleceń:

  • polecenia systemu są obsługiwane bezpośrednio przez mcI, a nie przez sterownik.
  • wymagane polecenia są obsługiwane przez sterownik. Wszystkie sterowniki MCI muszą obsługiwać wymagane polecenia i flagi.
  • podstawowe polecenia (lub opcjonalne) są używane przez niektóre urządzenia. Jeśli urządzenie obsługuje podstawowe polecenie, musi obsługiwać zdefiniowany zestaw flag dla tego polecenia.
  • rozszerzone polecenia są specyficzne dla typu lub sterownika urządzenia. Rozszerzone polecenia obejmują polecenia, takie jak umieścić (MCI_PUT) i gdzie (MCI_WHERE) polecenia dla digitalvideo i nakładki typów urządzeń oraz rozszerzenia istniejących poleceń (takich jak flaga "stretch"stanu(MCI_STATUS) dla typu urządzenia nakładki).

Chociaż systemowe i wymagane polecenia są minimalnym zestawem poleceń dla każdego sterownika MCI, podstawowe i rozszerzone polecenia nie są obsługiwane przez wszystkie sterowniki. Aplikacja zawsze może używać poleceń systemowych i wymaganych oraz ich flag, ale jeśli musi używać podstawowego lub rozszerzonego polecenia lub flagi, należy najpierw wykonać zapytanie względem sterownika przy użyciu możliwości (MCI_GETDEVCAPS). W poniższych sekcjach podsumowano konkretne polecenia w każdej kategorii.

Polecenia systemowe

Interfejs MCI przetwarza następujące polecenia systemowe bezpośrednio, zamiast przekazywać je do urządzeń MCI.

Struna Komunikat Opis
przerwania MCI_BREAK Ustawia klucz przerwania dla urządzenia MCI.
sysinfo MCI_SYSINFO Zwraca informacje o urządzeniach MCI.

 

Wymagane polecenia

Wszystkie urządzenia MCI obsługują następujące wymagane polecenia.

Struna Komunikat Opis
możliwości MCI_GETDEVCAPS Uzyskuje możliwości urządzenia.
zamknij MCI_CLOSE Zamyka urządzenie.
informacji MCI_INFO Uzyskuje informacje tekstowe z urządzenia.
otwórz MCI_OPEN Inicjuje urządzenie.
stanu MCI_STATUS Uzyskuje informacje o stanie z urządzenia. Niektóre flagi tego polecenia nie są wymagane, więc jest to również podstawowe polecenie.

 

Urządzenia muszą również obsługiwać standardowy zestaw flag poleceń dla wymaganych poleceń.

Podstawowe polecenia

Poniższa lista zawiera podsumowanie podstawowych poleceń. Użycie tych poleceń przez urządzenie MCI jest opcjonalne.

Struna Komunikat Opis
ładowanie MCI_LOAD Ładuje dane z pliku.
wstrzymać MCI_PAUSE Zatrzymuje odtwarzanie. Odtwarzanie lub nagrywanie można wznowić w bieżącej pozycji.
odtwarzania MCI_PLAY Rozpoczyna przesyłanie danych wyjściowych.
rekordu MCI_RECORD Rozpoczyna rejestrowanie danych wejściowych.
wznowić MCI_RESUME Wznawia odtwarzanie lub nagrywanie na wstrzymanym urządzeniu.
zapisywania MCI_SAVE Zapisuje dane w pliku dysku.
MCI_SEEK Szuka do przodu lub do tyłu.
zestaw MCI_SET Ustawia stan operacyjny urządzenia.
stanu stan MCI Uzyskuje informacje o stanie urządzenia. Jest to również wymagane polecenie; ponieważ niektóre z jego flag nie są wymagane, jest również wymieniony tutaj. (Opcjonalne elementy obsługują urządzenia korzystające z nośnika liniowego z rozpoznawalnymi pozycjami).
zatrzymać MCI_STOP Zatrzymuje odtwarzanie.

 

Jeśli sterownik obsługuje podstawowe polecenie, musi również obsługiwać standardowy zestaw flag dla polecenia.

Polecenia rozszerzone

Niektóre urządzenia MCI mają dodatkowe polecenia lub dodają flagi do istniejących poleceń. Chociaż niektóre rozszerzone polecenia dotyczą tylko określonego sterownika urządzenia, większość z nich ma zastosowanie do wszystkich sterowników określonego typu urządzenia. Na przykład zestaw poleceń dla sequencer typ urządzenia rozszerza zestaw (MCI_SET) polecenia, aby dodać formaty czasu wymagane przez sekwencje MIDI.

Nie należy zakładać, że urządzenie obsługuje rozszerzone polecenia lub flagi. Aby określić, czy dana funkcja jest obsługiwana, możesz użyć polecenia (MCI_GETDEVCAPS), aby określić, czy dana funkcja jest obsługiwana, a aplikacja powinna być gotowa do obsługi "nieobsługiwanego polecenia" lub "nieobsługiwanej funkcji".

Następujące rozszerzone polecenia są dostępne dla wymienionych typów urządzeń.

Struna Komunikat Typy urządzeń Opis
konfigurowanie MCI_CONFIGURE digitalvideo Wyświetla okno dialogowe konfiguracji.
cue MCI_CUE digitalvideo, waveaudio Przygotowuje się do odtwarzania lub nagrywania.
usuwanie MCI_DELETE waveaudio Usuwa segment danych z pliku multimedialnego.
ucieczki MCI_ESCAPE videodisc Wysyła informacje niestandardowe do urządzenia.
blokowanie MCI_FREEZE pokrycie Wyłącza pozyskiwanie wideo do buforu ramki.
umieścić PUT MCI digitalvideo, nakładka Definiuje okna źródłowe, docelowe i ramowe.
zrealizować MCI_REALIZE digitalvideo Informuje urządzenie, aby wybrało paletę i zrealizowało jej paletę w kontekście urządzenia wyświetlanego okna.
setaudio MCI_ SETAUDIO digitalvideo Ustawia parametry audio dla wideo.
setvideo MCI_ SETVIDEO digitalvideo Ustawia parametry wideo.
sygnału MCI_SIGNAL digitalvideo Identyfikuje określoną pozycję z sygnałem.
spin MCI_SPIN videodisc Rozpoczyna obracanie się dysku lub zatrzymuje obracanie się dysku.
krok MCI_STEP digitalvideo, videodisc Krok odtwórz jedną lub więcej ramek do przodu lub odwrotnie.
odmrozić MCI_UNFREEZE pokrycie Umożliwia buforowi ramki uzyskiwanie danych wideo.
aktualizacji MCI_UPDATE digitalvideo Przemaluje bieżącą ramkę w kontekście urządzenia.
gdzie MCI WHERE digitalvideo, nakładka Uzyskuje prostokąt określający obszar źródłowy, docelowy lub ramkowy.
okna MCI_WINDOW digitalvideo, nakładka Steruje oknem wyświetlania.