waveInGetPosition-Funktion (mmeapi.h)
[waveInGetPosition wird ab Windows Vista nicht mehr unterstützt. Verwenden Sie stattdessen IAudioClock::GetPosition.]
Die waveInGetPosition-Funktion ruft die aktuelle Eingabeposition des angegebenen Waveform-Audio-Eingabegeräts ab.
Syntax
MMRESULT waveInGetPosition(
HWAVEIN hwi,
LPMMTIME pmmt,
UINT cbmmt
);
Parameter
hwi
Handle mit dem Waveform-Audio-Eingabegerät.
pmmt
Zeiger auf eine MMTIME-Struktur .
cbmmt
Größe der MMTIME-Struktur in Bytes.
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
Legen Sie vor dem Aufrufen dieser Funktion das wType-Element der MMTIME-Struktur so fest, dass das gewünschte Zeitformat angegeben wird. Überprüfen Sie nach dem Aufrufen dieser Funktion wType , um zu ermitteln, ob das gewünschte Zeitformat unterstützt wird. Wenn das Format nicht unterstützt wird, gibt das Element ein alternatives Format an.
Die Position wird auf null festgelegt, wenn das Gerät geöffnet oder zurückgesetzt wird.
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ßlich Windows.h) |
| Bibliothek | Winmm.lib |
| DLL | Winmm.dll |