IMMNotificationClient::OnDeviceAdded method (mmdeviceapi.h)

Article
02/22/2024

The OnDeviceAdded method indicates that a new audio endpoint device has been added.

Syntax

HRESULT OnDeviceAdded(
  [in] LPCWSTR pwstrDeviceId
);

Parameters

[in] pwstrDeviceId

Pointer to the endpoint ID string that identifies the audio endpoint device. This parameter points to a null-terminated, wide-character string containing the endpoint ID. The string remains valid for the duration of the call.

Return value

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

For a code example that implements the OnDeviceAdded method, see Device Events.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	mmdeviceapi.h