Microsoft DirectX 8.0 (C++)

GetDeviceID

Retrieves the unique device identifier of the default playback and capture devices selected by the user under Sounds and Multimedia in Control Panel.

HRESULT GetDeviceID(
  LPCGUID pGuidSrc, 
  LPGUID pGuidDest
);

Parameters

pGuidSrc
Address of a variable of type GUID that specifies a valid device identifier, or the address of one of the following predefined variables.
DSDEVID_DefaultPlayback
System-wide default audio playback device.
DSDEVID_DefaultCapture
System-wide default audio capture device.
DSDEVID_DefaultVoicePlayback
Default voice playback device.
DSDEVID_DefaultVoiceCapture
Default voice capture device.
pGuidDest
Address of a variable of type GUID that receives the unique identifier of the device.

Return Values

If the function succeeds, the return value is DS_OK.

If the function fails, the return value may be DSERR_INVALIDPARAM.

Remarks

If pGuidSrc points to a valid device identifier, the same value is returned in pGuidDest. If pGuidSrc is one of the listed constants, pGuidDest returns the address of the corresponding device GUID.

Requirements

  Header: Declared in dsound.h.
  Import Library: Use dsound.lib.