IDeviceSpecificProperty::Get4BRange-Methode (devicetopology.h)

Artikel
02/26/2024

Die Get4BRange-Methode ruft den 4-Byte-Bereich des gerätespezifischen Eigenschaftswerts ab.

Syntax

HRESULT Get4BRange(
  [out] LONG *plMin,
  [out] LONG *plMax,
  [out] LONG *plStepping
);

Parameter

[out] plMin

Zeiger auf eine LONG-Variable , in die die Methode den minimalen Eigenschaftswert schreibt.

[out] plMax

Zeiger auf eine LONG-Variable , in die die Methode den maximalen Eigenschaftswert schreibt.

[out] plStepping

Zeiger auf eine LONG-Variable , in die die Methode den Schrittwert zwischen aufeinanderfolgenden Eigenschaftswerten im Bereich *plMin bis *plMax schreibt. Wenn die Differenz zwischen den maximalen und minimalen Eigenschaftswerten d ist und der Bereich in n Schritte (gleichmäßig große Intervalle) unterteilt wird, kann die Eigenschaft n + 1 diskrete Werte annehmen, und die Größe des Schritts zwischen aufeinanderfolgenden Werten ist d /n.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
E_POINTER	Der Zeiger plMin, plMax oder plStepping ist NULL.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Der Eigenschaftswert ist keine 32-Bit-Ganzzahl mit Vorzeichen oder Vorzeichen. Informationen zu diesem Makro finden Sie in der Windows SDK-Dokumentation.

Hinweise

Diese Methode meldet den Bereich und die Schrittgröße für einen Eigenschaftswert, bei dem es sich um eine 32-Bit-Ganzzahl mit Vorzeichen oder ohne Vorzeichen handelt. Diese beiden Datentypen werden durch VARENUM-Enumerationskonstanten VT_I4 bzw. VT_UI4 dargestellt. Wenn der Eigenschaftswert keine 32-Bit-Ganzzahl ist, gibt die Methode einen Fehler status Code zurück. Weitere Informationen zu VARENUM finden Sie in der Windows SDK-Dokumentation.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	devicetopology.h