waveInOpen-Funktion (mmeapi.h)
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 |
---|---|
|
Die angegebene Ressource ist bereits zugeordnet. |
|
Der angegebene Gerätebezeichner liegt außerhalb des Bereichs. |
|
Es ist kein Gerätetreiber vorhanden. |
|
Speicher kann nicht zugeordnet oder gesperrt werden. |
|
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 |