Windows Media Format SDK banner art
PreviousNext

IWMDMDevice::GetDeviceIcon

The GetDeviceIcon method retrieves a handle to the icon that the device service provider displays when the device is operating.

Syntax

HRESULT GetDeviceIcon(
  ULONG*  phIcon
);

Parameters

  phIcon

[out]  Handle to an icon.

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 phIcon parameter is either an invalid or NULL pointer.
E_FAIL An unspecified error occurred.

Remarks

The device Service Provider specifies which icon to retrieve. Before using it, the caller must cast the retrieved ULONG handle to an HICON. When the application is finished with the icon, it must call DestroyIcon to free the memory. DestroyIcon is a standard Win32 function.

See Also

PreviousNext


© 1999 Microsoft Corporation. All rights reserved.