Freigeben über

CM_Get_Device_Interface_PropertyW-Funktion (cfgmgr32.h)

  • Artikel

Die CM_Get_Device_Interface_Property-Funktion ruft eine Geräteeigenschaft ab, die für eine Geräteschnittstelle festgelegt ist.

Syntax

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

Parameter

[in] pszDeviceInterface

Zeiger auf eine Zeichenfolge, die die Geräteschnittstelle identifiziert, von der instance die Eigenschaft abgerufen werden soll.

[in] PropertyKey

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

[out] PropertyType

Zeiger auf eine DEVPROPTYPE-typisierte Variable, die den Property-Data-Type-Bezeichner der angeforderten Geräteschnittstelleneigenschaft empfängt. Der Property-Data-Type-Bezeichner ist ein bitweises OR zwischen einem Basisdatentypbezeichner und, wenn der Basisdatentyp geändert wird, einem Property-Data-Type-Modifizierer.

[out] PropertyBuffer

Ein Zeiger auf einen Puffer, der die angeforderte Geräteschnittstelleneigenschaft empfängt. CM_Get_Device_Interface_Property ruft die angeforderte Eigenschaft nur ab, wenn der Puffer groß genug ist, um alle Eigenschaftenwertdaten zu enthalten. Der Zeiger kann NULL sein.

[in, out] PropertyBufferSize

Die Größe des PropertyBuffer-Puffers in Bytes. Wenn PropertyBuffer auf NULL festgelegt ist, muss *PropertyBufferSize auf null festgelegt werden. Wenn der Puffer nicht groß genug ist, um alle Eigenschaftswertdaten aufzunehmen, gibt CM_Get_Device_Interface_Property als Ausgabe die Größe der Daten in Bytes in *PropertyBufferSize zurück.

[in] ulFlags

Reserviert. Muss auf 0 (null) festgelegt 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

CM_Get_Device_Interface_Property ist Teil des einheitlichen Geräteeigenschaftenmodells.

Anforderungen

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

Weitere Informationen

SetupDiGetDeviceInterfaceProperty