Win32APIのwaveOutGetVolume関数の呼び出し方法について

前提

PythonでWin32APIを呼び出してデバイスの音量を取得したいです。
waveOutVolumeGet関数を呼び出して取得したいです。
デバイスのハンドルの取得はできていて、エラーも発生しなかったので問題ないと思うのですが、
結果が0しか返ってきませんでした。

ソースコード

Python
1import ctypes
2from ctypes import wintypes
3
4
5CALLBACK_NULL = 0x0000_0000
6
7class WAVEFORMATEX(ctypes.Structure):
8    _fields_ = [("wFormatTag", wintypes.WORD),
9                ("nChannels", wintypes.WORD),
10                ("nSamplesPerSec", wintypes.DWORD),
11                ("nAvgBytesPerSec", wintypes.DWORD),
12                ("nBlockAlign", wintypes.WORD),
13                ("wBitsPerSample", wintypes.WORD),
14                ("cbSize", wintypes.WORD)]
15
16
17def get_volume() -> int:
18    wave_format = WAVEFORMATEX()
19    wave_format.wFormatTag = 1 # WAVE_FORMAT_PCM
20    wave_format.nChannels = 2
21    wave_format.nSamplesPerSec = 44100
22    wave_format.nAvgBytesPerSec = 176400
23    wave_format.nBlockAlign = 4
24    wave_format.wBitsPerSample = 16
25    wave_format.cbSize = 0
26
27    winmm = ctypes.windll.winmm
28    waveOutOpen = winmm.waveOutOpen
29    waveOutOpen.argtypes = [wintypes.HANDLE, wintypes.UINT, WAVEFORMATEX, ctypes.c_void_p, ctypes.c_void_p, ctypes.c_uint]
30    waveOutOpen.restype = ctypes.c_uint
31
32    device_handle = wintypes.HANDLE()
33    open_result = waveOutOpen(ctypes.byref(device_handle), wintypes.UINT(-1), wave_format, 0, 0, CALLBACK_NULL)
34
35    print("waveOutOpen errorCode", open_result)
36    print("outputDevice", device_handle)
37
38    vol = ctypes.c_uint()  # この変数のポインタを指定して関数を実行
39    get_vol = winmm.waveOutGetVolume(device_handle, ctypes.byref(vol))
40    print("waveOutGetVolume errorCode", get_vol)
41    return vol.value
42
43a = get_volume()
44print("\nresult", a)

試したこと

waveOutOpen関数の第二引数を違う値に変更

補足情報（FW/ツールのバージョンなど）

Windows11 バージョン22H2
Python 3.10.7

参考にしたドキュメント

行動規範の内容に同意します

回答1件

ベストアンサー

waveOutOpen関数の3つ目の引数が、WAVEFORMATEX型のポインターになっていなかったり、volの型がctypes.c_ulong()またはwintypes.DWORD()になっていなかったりしていますが、私の環境では取得できました。

結果が0であるということは、音量が0である可能性があります。
waveOutOpen関数でデバイスを開いた状態(time.sleep関数を使うなどで開いた状態を保持する)で、通知領域のスピーカーアイコンを右クリックし「音量ミキサーを開く(M)」を選択して表示される音量ミキサーで、Pythonの音量が0でないか確認すると良いと思います。

Python
1import ctypes
2from ctypes import wintypes
3
4CALLBACK_NULL = 0x0000_0000
5
6class WAVEFORMATEX(ctypes.Structure):
7    _fields_ = [("wFormatTag", wintypes.WORD),
8                ("nChannels", wintypes.WORD),
9                ("nSamplesPerSec", wintypes.DWORD),
10                ("nAvgBytesPerSec", wintypes.DWORD),
11                ("nBlockAlign", wintypes.WORD),
12                ("wBitsPerSample", wintypes.WORD),
13                ("cbSize", wintypes.WORD)]
14
15def main():
16    wave_format = WAVEFORMATEX()
17    wave_format.wFormatTag = 1 # WAVE_FORMAT_PCM
18    wave_format.nChannels = 2
19    wave_format.nSamplesPerSec = 44100
20    wave_format.nAvgBytesPerSec = 176400
21    wave_format.nBlockAlign = 4
22    wave_format.wBitsPerSample = 16
23    wave_format.cbSize = 0
24
25    winmm = ctypes.windll.winmm
26    waveOutOpen = winmm.waveOutOpen
27
28    device_handle = wintypes.HANDLE()
29    open_result = waveOutOpen(ctypes.byref(device_handle), wintypes.UINT(-1), ctypes.byref(wave_format), 0, 0, CALLBACK_NULL)
30    print("waveOutOpen errorCode", open_result)
31
32
33    # import time
34    # time.sleep(30)
35
36    vol = wintypes.DWORD() 
37    get_vol = winmm.waveOutGetVolume(device_handle, ctypes.byref(vol))
38    print("waveOutGetVolume errorCode", get_vol)
39
40    winmm.waveOutClose(device_handle)
41
42    print(f"\nresult : {vol.value:08X}")
43    print(f"左チャネル : {vol.value&0xffff:04X}")
44    print(f"右チャネル : {vol.value>>16:04X}")
45
46main()