C++ Windows 句柄基礎：從 HWND、HINSTANCE 到裝置控制的學習路徑

學習資源推薦

快速入門：取得預設喇叭音量控制介面

#include <mmdeviceapi.h>
#include <endpointvolume.h>
#include <iostream>

#pragma comment(lib, "Ole32.lib")

int main() {
    CoInitialize(nullptr);
    IMMDeviceEnumerator* pEnumerator = nullptr;
    CoCreateInstance(__uuidof(MMDeviceEnumerator), nullptr, CLSCTX_ALL, 
                     __uuidof(IMMDeviceEnumerator), (void**)&pEnumerator);
    
    IMMDevice* pDevice = nullptr;
    pEnumerator->GetDefaultAudioEndpoint(eRender, eConsole, &pDevice);
    
    IAudioEndpointVolume* pVolume = nullptr;
    pDevice->Activate(__uuidof(IAudioEndpointVolume), CLSCTX_ALL, nullptr, (void**)&pVolume);
    
    float currentVol = 0;
    pVolume->GetMasterVolumeLevelScalar(¤tVol);
    std::cout << "Current volume: " << (currentVol * 100) << "%\n";
    
    pVolume->SetMasterVolumeLevelScalar(0.5f, nullptr); // 設 50%
    
    pVolume->Release(); pDevice->Release(); pEnumerator->Release();
    CoUninitialize();
    return 0;
}

關鍵觀念釐清

• **句柄 ≠ 指標**：不能解參考，只能傳給 API。
• **外置聲卡控制**：若廠商提供 DLL，通常封裝了 Core Audio 或自定義 IOCTL，直接呼叫 DLL 匯出函數即可，**不需自行處理 HWND**。
• **權限**：控制音訊端點需在「音訊端點建立者」或管理員權限下，否則 Activate 會回傳 E_ACCESSDENIED。

總結

控制外置聲卡請直接學習 **Core Audio API (IMMDeviceEnumerator, IAudioEndpointVolume)**，參考 Microsoft 官方文件與 GitHub 範例。句柄只是核心物件的代號，掌握「取得介面 → 呼叫方法 → 釋放介面」的 COM 模式即可，無須深究 HWND 內部結構。