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 a 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 à Irp->AssociatedIrp.SystemBuffer.
Longueur de la mémoire tampon de sortie
Parameters.DeviceIoControl.OutputBufferLength à 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 taille de(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 d’état peut être défini sur STATUS_SUCCESS, ou éventuellement sur STATUS_INVALID_BUFFER_SIZE ou STATUS_INSUFFICIENT_RESOURCES.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntddstor.h (include Ntddstor.h) |