HidD_GetSerialNumberString-Funktion (hidsdi.h)
Die HidD_GetSerialNumberString Routine gibt die eingebettete Zeichenfolge einer Auflistung der obersten Ebene zurück, die die Seriennummer des physischen Geräts der Sammlung identifiziert.
Syntax
BOOLEAN HidD_GetSerialNumberString(
[in] HANDLE HidDeviceObject,
[out] PVOID Buffer,
[in] ULONG BufferLength
);
Parameter
[in] HidDeviceObject
Gibt ein geöffnetes Handle für eine Auflistung der obersten Ebene an.
[out] Buffer
Zeiger auf einen vom Aufrufer zugewiesenen Puffer, den die Routine verwendet, um die angeforderte Seriennummernzeichenfolge zurückzugeben. Die Routine gibt eine MIT NULL beendete breite Zeichenfolge zurück.
[in] BufferLength
Gibt die Länge eines vom Aufrufer zugewiesenen Puffers in Bytes an, der bei Buffer bereitgestellt wird. Wenn der Puffer nicht groß genug ist, um die gesamte eingebettete NULL-Zeichenfolge zurückzugeben, gibt die Routine nichts im Puffer zurück. Der bereitgestellte Puffer muss = 4093 Bytes (2^12 – 3) sein <.
Rückgabewert
HidD_GetSerialNumberString gibt TRUE zurück, wenn die gesamte eingebettete NULL-Zeichenfolge erfolgreich zurückgegeben wird. Andernfalls gibt die Routine FALSE zurück. Verwenden Sie GetLastError , um erweiterte Fehlerinformationen abzurufen.
Hinweise
Nur Anwendungen im Benutzermodus können HidD_GetSerialNumberString aufrufen. Kernelmodustreiber können IOCTL_HID_GET_SERIALNUMBER_STRING verwenden.
Die maximal mögliche Anzahl von Zeichen in einer eingebetteten Zeichenfolge ist gerätespezifisch. Für USB-Geräte beträgt die maximale Zeichenfolgenlänge 126 breite Zeichen (ohne das beendende NULL-Zeichen).
Wenn der angegebene Puffer nicht <= 4093 Bytes (2^12 – 3) ist, schlägt der Aufruf möglicherweise (abhängig vom zugrunde liegenden Protokoll HID/Bluetooth/SPI) mit fehlercode ERROR_GEN_FAILURE (0x0000001f) fehl.
Weitere Informationen finden Sie unter HID-Sammlungen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Universell |
| Header | hidsdi.h (include Hidsdi.h) |
| Bibliothek | Hid.lib |
| DLL | Hid.dll |