Freigeben über


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

IRP_MJ_DEVICE_CONTROL

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)

Weitere Informationen

MEDIA_SERIAL_NUMBER_DATA