waveInStart-Funktion (mmeapi.h)
Die waveInStart-Funktion startet die Eingabe auf dem angegebenen Waveform-Audio-Eingabegerät.
Syntax
MMRESULT waveInStart(
HWAVEIN hwi
);
Parameter
hwi
Handle für das Waveform-Audio-Eingabegerät.
Rückgabewert
Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist. Mögliche Fehlerwerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Das angegebene Gerätehandle ist ungültig. |
|
Es ist kein Gerätetreiber vorhanden. |
|
Speicher kann nicht zugeordnet oder gesperrt werden. |
Hinweise
Puffer werden an die Anwendung zurückgegeben, wenn sie voll sind oder wenn die waveInReset-Funktion aufgerufen wird (das dwBytesRecorded-Element im Header enthält die Länge der Daten). Wenn keine Puffer in der Warteschlange vorhanden sind, werden die Daten weggeworfen, ohne die Anwendung zu benachrichtigen, und die Eingabe wird fortgesetzt.
Das Aufrufen dieser Funktion, wenn die Eingabe bereits gestartet wurde, hat keine Auswirkung, und die Funktion gibt null zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mmeapi.h (Einschließen von Windows.h) |
| Bibliothek | Winmm.lib |
| DLL | Winmm.dll |