AdvertiseInterface

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

This function allows a driver to announce what interfaces it exposes.

Syntax

BOOL AdvertiseInterface(
  const GUID* devclass,
  LPCWSTR name,
  BOOL fAdd
);

Parameters

• devclass
  [in] Pointer to a device interface globally unique identifier (GUID). It cannot be NULL. For information on the predefined device interface GUIDs, see Device Interfaces.

• name
  [in] Name of the interface instance. Use this name to identify this instance in whatever way the interface requires. This name must be unique in the interface's access namespace. Therefore, "DSK2:" might be available in both the generic stream interface namespace and the block interface namespace, and will probably, but not necessarily, refer to the same actual driver.

• fAdd
  [in] Data to specify whether to add or remove the interface. Set to TRUE if the interface was added. Set to FALSE if the interface was removed.

Return Value

TRUE indicates success. FALSE indicates failure. Reasons for failure include a GUID that is not unique and name, permission denied, and insufficient memory to track the interface. It also fails if you attempt to remove an interface that was never added.

Remarks

Adding an interface with AdvertiseInterface allocates resources within the Device Manager. Be sure to advertise its removal before the driver is unloaded.

Requirements

See Also

Concepts

Device Interfaces