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
MMSYSERR_INVALHANDLE	Das angegebene Gerätehandle ist ungültig.
MMSYSERR_NODRIVER	Es ist kein Gerätetreiber vorhanden.
MMSYSERR_NOMEM	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

Weitere Informationen

Waveform-Audio

Wellenformfunktionen