waveInOpen-Funktion (mmeapi.h)

  • Artikel

Die waveInOpen-Funktion öffnet das angegebene Waveform-Audio-Eingabegerät für die Aufzeichnung.

Syntax

MMRESULT waveInOpen(
  LPHWAVEIN       phwi,
  UINT            uDeviceID,
  LPCWAVEFORMATEX pwfx,
  DWORD_PTR       dwCallback,
  DWORD_PTR       dwInstance,
  DWORD           fdwOpen
);

Parameter

phwi

Zeiger auf einen Puffer, der ein Handle empfängt, das das Offene Wellenform-Audio-Eingabegerät identifiziert. Verwenden Sie dieses Handle, um das Gerät beim Aufrufen anderer Waveform-Audio-Eingabefunktionen zu identifizieren. Dieser Parameter kann NULL sein, wenn WAVE_FORMAT_QUERY für fdwOpen angegeben ist.

uDeviceID

Bezeichner des zu öffnenden Waveform-Audio-Eingabegeräts. Dabei kann es sich entweder um einen Gerätebezeichner oder um ein Handle eines Offenwellenform-Audioeingabegeräts handelt. Sie können das folgende Flag anstelle eines Gerätebezeichners verwenden.

Wert Bedeutung
WAVE_MAPPER Die Funktion wählt ein Waveform-Audio-Eingabegerät aus, das in der Lage ist, im angegebenen Format zu aufzeichnen.

pwfx

Zeiger auf eine WAVEFORMATEX-Struktur , die das gewünschte Format für die Aufzeichnung von Waveform-Audiodaten identifiziert. Sie können diese Struktur sofort nach der Rückgabe von waveInOpen freigeben.

dwCallback

Zeiger auf eine feste Rückruffunktion, ein Ereignishandle, ein Handle zu einem Fenster oder den Bezeichner eines Threads, der während der Waveform-Audioaufzeichnung aufgerufen werden soll, um Meldungen im Zusammenhang mit dem Aufzeichnungsfortschritt zu verarbeiten. Wenn keine Rückruffunktion erforderlich ist, kann dieser Wert null sein. Weitere Informationen zur Rückruffunktion finden Sie unter waveInProc.

dwInstance

Benutzer-instance Daten, die an den Rückrufmechanismus übergeben werden. Dieser Parameter wird nicht mit dem Fensterrückrufmechanismus verwendet.

fdwOpen

Flags zum Öffnen des Geräts. Die folgenden Werte werden definiert.

Wert Bedeutung
CALLBACK_EVENT Der dwCallback-Parameter ist ein Ereignishandle.
CALLBACK_FUNCTION Der dwCallback-Parameter ist eine Rückrufprozeduradresse.
CALLBACK_NULL Kein Rückrufmechanismus. Dies ist die Standardeinstellung.
CALLBACK_THREAD Der dwCallback-Parameter ist ein Threadbezeichner.
CALLBACK_WINDOW Der dwCallback-Parameter ist ein Fensterhandle.
WAVE_MAPPED_DEFAULT_COMMUNICATION_DEVICE Wenn dieses Flag angegeben ist und der uDeviceID-ParameterWAVE_MAPPER ist, öffnet die Funktion das Standardkommunikationsgerät.

Dieses Flag gilt nur, wenn uDeviceIDgleich WAVE_MAPPER.

Hinweis Erfordert Windows 7
 
WAVE_FORMAT_DIRECT Wenn dieses Flag angegeben ist, führt der ACM-Treiber keine Konvertierungen für die Audiodaten durch.
WAVE_FORMAT_QUERY Die Funktion fragt das Gerät ab, um zu bestimmen, ob es das angegebene Format unterstützt, aber das Gerät wird nicht geöffnet.
WAVE_MAPPED Der uDeviceID-Parameter gibt ein Waveform-Audio-Gerät an, das vom Wave Mapper zugeordnet werden soll.

Rückgabewert

Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:

Rückgabecode Beschreibung
MMSYSERR_ALLOCATED
 Die angegebene Ressource ist bereits zugeordnet.
MMSYSERR_BADDEVICEID
 Der angegebene Gerätebezeichner liegt außerhalb des Bereichs.
MMSYSERR_NODRIVER
 Es ist kein Gerätetreiber vorhanden.
MMSYSERR_NOMEM
 Speicher kann nicht zugeordnet oder gesperrt werden.
WAVERR_BADFORMAT
 Es wurde versucht, mit einem nicht unterstützten Waveform-Audioformat zu öffnen.

Hinweise

Verwenden Sie die waveInGetNumDevs-Funktion , um die Anzahl der im System vorhandenen Waveform-Audio-Eingabegeräte zu bestimmen. Der von uDeviceID angegebene Gerätebezeichner variiert von null bis 1 kleiner als die Anzahl der vorhandenen Geräte. Die WAVE_MAPPER-Konstante kann auch als Gerätebezeichner verwendet werden.

Wenn Sie sich dafür entscheiden, dass ein Fenster oder Thread Rückrufinformationen empfängt, werden die folgenden Meldungen an die Fensterprozedur oder den Thread gesendet, um den Fortschritt der Waveform-Audioeingabe anzugeben: MM_WIM_OPEN, MM_WIM_CLOSE und MM_WIM_DATA.

Wenn Sie sich dafür entscheiden, dass eine Funktion Rückrufinformationen empfängt, werden die folgenden Meldungen an die Funktion gesendet, um den Fortschritt der Waveform-Audioeingabe anzugeben: WIM_OPEN, WIM_CLOSE und WIM_DATA.

Anforderungen

   
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