CM_Get_Device_Interface_PropertyW-Funktion (cfgmgr32.h)

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

Weitere Informationen

SetupDiGetDeviceInterfaceProperty