CM_Add_IDA-Funktion (cfgmgr32.h)

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.

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

Weitere Informationen

CM_Add_ID_Ex
CM_Get_Child