IOCTL_STORAGE_GET_MEDIA_SERIAL_NUMBER IOCTL (ntddstor.h)
Interroge le pilote parent générique USB pour le numéro de série d’un périphérique USB. Si un périphérique USB dispose d’une interface de sécurité de contenu CSM-1, un pilote client USB peut interroger son numéro de série à l’aide de cette requête. Les pilotes clients USB qui aident à implémenter un système de gestion des droits numériques (DRM) peuvent utiliser ces informations pour s’assurer que seuls les clients légitimes ont accès à la propriété intellectuelle numérisée.
Code principal
Mémoire tampon d'entrée
Aucun.
Longueur de la mémoire tampon d’entrée
Aucun.
Mémoire tampon de sortie
Le pilote retourne le numéro de série de l’appareil indiqué dans une structure de type MEDIA_SERIAL_NUMBER_DATA dans la mémoire tampon sur Irp-AssociatedIrp.SystemBuffer>.
Longueur de la mémoire tampon de sortie
Parameters.DeviceIoControl.OutputBufferLength dans l’emplacement de la pile d’E/S de l’IRP indique la taille, en octets, de la mémoire tampon, qui doit être au moins sizeof(MEDIA_SERIAL_NUMBER_DATA).
Bloc d’état
Le champ Informations est défini sur la taille, en octets, des données retournées. Le champ État peut être défini sur STATUS_SUCCESS, ou éventuellement sur STATUS_INVALID_BUFFER_SIZE ou STATUS_INSUFFICIENT_RESOURCES.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ntddstor.h (inclure Ntddstor.h) |