ThbWaveOut.DeviceName

This is the name of the waveform-audio output device. This property can be set to the exact name of the device. All available devices are listed in the ThbWaveOut.DeviceList property. If an exact match is found, the ThbWaveOut.DeviceID property is set to the list index and and the device is initialized. If the initialization succeeds, the ThbWaveOut.Available property is set to True.

The DeviceName property is useful for your application configuration because the name of the device is less likely to change than the DeviceID. The DeviceID is assigned by the Windows operating system and may change if other devices are added or deleted. For example, save the DeviceName property when exiting your application. When starting your application, retrieve the stored name and set this property.

hbWaveOut1.DeviceName := 'Sound Device #1';
if hbWaveOut1.Available then
begin
  try
   hbWaveOut1.Active := True;
  except
    // handle errors
  end;
end;

Availability

Design-Time: Read, Write / Run-Time: Read, Write

Declaration

property DeviceName: String;

Remarks

If the device is active prior to selecting a device, the current device is closed. Your application should not save the DeviceID to restore an users configuration because it could change in due to installing/removing sound devices. The better choice is to store the DeviceName

Availability

Declaration

Remarks

See Also