MM_MCINOTIFY Nachricht
Die MM_MCINOTIFY Meldung benachrichtigt eine Anwendung, dass ein MCI-Gerät einen Vorgang abgeschlossen hat. MCI-Geräte senden diese Nachricht nur, wenn das flag MCI_NOTIFY verwendet wird.
MM_MCINOTIFY
wParam = (WPARAM) wFlags
lParam = (LONG) lDevID
Parameter
-
wFlags
-
Grund für die Benachrichtigung. Die folgenden Werte werden definiert:
Anforderung Wert MCI_NOTIFY_ABORTED Das Gerät erhielt einen Befehl, der verhinderte, dass die aktuellen Bedingungen für das Initiieren der Rückruffunktion erfüllt wurden. Wenn ein neuer Befehl den aktuellen Befehl unterbricht und auch eine Benachrichtigung anfordert, sendet das Gerät nur diese Nachricht und nicht MCI_NOTIFY_SUPERSEDED MCI_NOTIFY_FAILURE Beim Ausführen des Befehls ist ein Gerätefehler aufgetreten. MCI_NOTIFY_SUCCESSFUL Die Bedingungen, die die Rückruffunktion initiieren, wurden erfüllt. MCI_NOTIFY_SUPERSEDED Das Gerät hat einen weiteren Befehl mit dem Flag "notify" erhalten, und die aktuellen Bedingungen für das Initiieren der Rückruffunktion wurden ersetzt. -
lDevID
-
Bezeichner des Geräts, das die Rückruffunktion initiiert.
Rückgabewert
Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.
Bemerkungen
Weitere Informationen zum MCI_NOTIFY-Flag finden Sie unter Das Benachrichtigen-Flag.
Ein Gerät gibt das MCI_NOTIFY_SUCCESSFUL-Flag mit MM_MCINOTIFY zurück, wenn die Aktion für einen Befehl abgeschlossen ist. Beispielsweise verwendet ein CD-Audiogerät dieses Flag für die Benachrichtigung für den Befehl wiedergabe ( MCI_PLAY), wenn das Gerät die Wiedergabe beendet. Der Wiedergabebefehl ist nur erfolgreich, wenn er die angegebene Endposition erreicht oder das Ende des Mediums erreicht. Ebenso geben die Befehle seek ( MCI_SEEK) und record ( MCI_RECORD) nicht MCI_NOTIFY_SUCCESSFUL zurück, bis sie die angegebene Endposition erreichen oder das Ende des Mediums erreichen.
Ein Gerät gibt das MCI_NOTIFY_ABORTED-Flag mit MM_MCINOTIFY nur zurück, wenn es einen Befehl empfängt, der verhindert, dass es die Benachrichtigungsbedingungen erfüllt. Beispielsweise würde der Wiedergabebefehl die Benachrichtigung für einen vorherigen Wiedergabebefehl nicht abbrechen, vorausgesetzt, der neue Befehl ändert weder die Wiedergaberichtung noch die Endposition. Die Such- und Aufzeichnungsbefehle verhalten sich ähnlich. MCI sendet auch keine MCI_NOTIFY_ABORTED, wenn die Wiedergabe oder Aufzeichnung mit dem Befehl pause ( MCI_PAUSE) angehalten wird. Durch das Senden des Befehls resume ( MCI_RESUME) können sie weiterhin die Rückrufbedingungen erfüllen.
Wenn Ihre Anwendung eine Benachrichtigung für einen Befehl anfordert, überprüfen Sie die Fehlerrückgabe der Funktionen mciSendString oder mciSendCommand . Wenn für diese Funktionen ein Fehler auftritt und ein Wert ohne Wert zurückgegeben wird, legt MCI keine Benachrichtigung für den Befehl fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|