CM_Set_Device_Interface_PropertyW-Funktion (cfgmgr32.h)

Die CM_Set_Device_Interface_Property-Funktion legt eine Geräteeigenschaft einer Geräteschnittstelle fest.

Syntax

CMAPI CONFIGRET CM_Set_Device_Interface_PropertyW(
  [in] LPCWSTR          pszDeviceInterface,
  [in] const DEVPROPKEY *PropertyKey,
  [in] DEVPROPTYPE      PropertyType,
  [in] const PBYTE      PropertyBuffer,
  [in] ULONG            PropertyBufferSize,
  [in] ULONG            ulFlags
);

Parameter

[in] pszDeviceInterface

Zeiger auf eine Zeichenfolge, die die Geräteschnittstelle identifiziert, instance für die eine Eigenschaft festgelegt werden soll.

[in] PropertyKey

Zeiger auf eine DEVPROPKEY-Struktur , die den Eigenschaftenschlüssel der festzulegenden Geräteschnittstelleneigenschaft darstellt.

[in] PropertyType

Ein DEVPROPTYPE-typisierter Wert, der den Bezeichner property-data-type für die Geräteschnittstelleneigenschaft darstellt. Um eine Eigenschaft zu löschen, muss diese auf DEVPROP_TYPE_EMPTY festgelegt werden.

[in] PropertyBuffer

Zeiger auf einen Puffer, der den Eigenschaftswert der Geräteschnittstelleneigenschaft enthält. Wenn entweder die Eigenschaft oder die Daten gelöscht werden, muss dieser Zeiger auf NULL festgelegt werden, und PropertyBufferSize muss auf 0 festgelegt werden.

[in] PropertyBufferSize

Die Größe des PropertyBuffer-Puffers in Bytes. Wenn PropertyBuffer auf NULL festgelegt ist, muss PropertyBufferSize auf 0 festgelegt werden.

[in] ulFlags

Reserviert. Muss auf 0 festgelegt werden.

Rückgabewert

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

Hinweise

CM_Set_Device_Interface_Property ist Teil des Unified Device-Eigenschaftsmodells.

Anforderungen

Weitere Informationen

SetupDiSetDeviceInterfaceProperty