IOCTL_STORAGE_GET_MEDIA_SERIAL_NUMBER IOCTL (ntddstor.h)
Fragt den generischen übergeordneten USB-Treiber nach der Seriennummer eines USB-Geräts ab. Wenn ein USB-Gerät über eine CSM-1-Inhaltssicherheitsschnittstelle verfügt, kann ein USB-Clienttreiber mithilfe dieser Anforderung die Seriennummer abfragen. USB-Clienttreiber, die bei der Implementierung eines DRM-Systems (Digital Rights Management) helfen, können diese Informationen verwenden, um sicherzustellen, dass nur legitime Kunden Zugriff auf digitalisiertes geistiges Eigentum haben.
Hauptcode
Eingabepuffer
Keine.
Eingabepufferlänge
Keine.
Ausgabepuffer
Der Treiber gibt die Seriennummer des angegebenen Geräts in einer Struktur vom Typ MEDIA_SERIAL_NUMBER_DATA im Puffer bei Irp-AssociatedIrp.SystemBuffer> zurück.
Länge des Ausgabepuffers
Parameters.DeviceIoControl.OutputBufferLength in der E/A-Stapelposition des IRP gibt die Größe des Puffers in Bytes an, die mindestens sizeof(MEDIA_SERIAL_NUMBER_DATA) sein muss.
Statusblock
Das Feld Information ist auf die Größe der zurückgegebenen Daten in Bytes festgelegt. Das Feld Status kann auf STATUS_SUCCESS oder möglicherweise auf STATUS_INVALID_BUFFER_SIZE oder STATUS_INSUFFICIENT_RESOURCES festgelegt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ntddstor.h (include Ntddstor.h) |