IWMDMDevice::GetName

The GetName method retrieves the name of an installed media device.

Syntax

HRESULT GetName(
  LPWSTR  pwszName,
  UINT  nMaxChars
);

Parameters

pwszName

[out] Pointer to a (Unicode) wide character NULL-terminated string containing the device name.

nMaxChars

[in] Integer containing the maximum number of characters that can be placed in pwszName.

Return Values

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

Return code	Description
E_INVALIDARG	The pwszName parameter is an invalid or NULL pointer.
WMDM_E_NOTSUPPORTED	The device does not have a name.
WMDM_E_BUFFERTOOSMALL	The buffer specified is too small for the return string. Check nMaxChars for the required buffer size.
E_FAIL	An unspecified error occurred.

See Also