CM_Add_IDA-Funktion (cfgmgr32.h)

  • Artikel

Die funktion CM_Add_ID fügt eine angegebene Geräte-ID (sofern nicht bereits vorhanden) an die Hardware-ID-Liste oder die Liste der kompatiblen ID eines Geräts instance an.

Syntax

CMAPI CONFIGRET CM_Add_IDA(
  DEVINST dnDevInst,
  PSTR    pszID,
  ULONG   ulFlags
);

Parameter

dnDevInst

Vom Aufrufer bereitgestelltes Gerät instance Handle, das an den lokalen Computer gebunden ist.

pszID

Vom Aufrufer bereitgestellter Zeiger auf eine MIT NULL endende Geräte-ID-Zeichenfolge.

ulFlags

Vom Aufrufer bereitgestellte Flagkonstante, die die Liste angibt, an die die angegebene Geräte-ID angefügt werden soll. Die folgenden Flagkonstanten sind gültig.

Flagkonstante Definition
CM_ADD_ID_COMPATIBLE Die angegebene Geräte-ID sollte an die Liste der kompatiblen ID des jeweiligen Geräts instance angefügt werden.
CM_ADD_ID_HARDWARE Die angegebene Geräte-ID sollte an die Hardware-ID-Liste des jeweiligen Geräts instance angefügt werden.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

Hinweise

Die funktion CM_Add_ID kann nur verwendet werden, wenn dnDevInst ein root-enumeriertes Gerät darstellt. Bei anderen Geräten meldet der Bustreiber Hardware und kompatible IDs, wenn er ein untergeordnetes Gerät aufzählt, nachdem er IRP_MN_QUERY_ID empfangen hat.

Jede angefügte Geräte-ID gilt als weniger kompatibel als IDs, die bereits in der angegebenen Liste vorhanden sind. Informationen zu Geräte-IDs, Hardware-IDs und kompatiblen IDs finden Sie unter Geräteidentifikationszeichenfolgen.

Aufrufer dieser Funktion müssen über SeLoadDriverPrivilege verfügen. (Berechtigungen werden in der dokumentation Microsoft Windows SDK beschrieben.)

Informationen zur Verwendung von Geräte- instance Handles, die an den lokalen Computer gebunden sind, finden Sie unter CM_Get_Child.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (include Cfgmgr32.h)
Bibliothek Cfgmgr32.lib

Weitere Informationen

CM_Add_ID_Ex
CM_Get_Child