IOCTL_STORAGE_GET_MEDIA_SERIAL_NUMBER IOCTL (ntddstor.h)
Esegue una query sul driver padre generico USB per il numero di serie di un dispositivo USB. Se un dispositivo USB ha un'interfaccia di sicurezza del contenuto CSM-1, un driver client USB può eseguire una query per il numero di serie usando questa richiesta. I driver client USB che consentono di implementare un sistema DRM (Digital Rights Management) possono usare queste informazioni per garantire che solo i clienti legittimi abbiano accesso alla proprietà intellettuale digitalizzata.
Codice principale
Buffer di input
Nessuno.
Lunghezza del buffer di input
Nessuno.
Buffer di output
Il driver restituisce il numero di serie del dispositivo indicato in una struttura di tipo MEDIA_SERIAL_NUMBER_DATA nel buffer in corrispondenza di Irp->AssociatedIrp.SystemBuffer.
Lunghezza del buffer di output
Parameters.DeviceIoControl.OutputBufferLength nella posizione dello stack di I/O dell'IRP indica le dimensioni, in byte, del buffer, che deve essere almeno sizeof(MEDIA_SERIAL_NUMBER_DATA).
Blocco di stato
Il campo informazioni è impostato sulle dimensioni, in byte, dei dati restituiti. Il campo stato può essere impostato su STATUS_SUCCESS oppure su STATUS_INVALID_BUFFER_SIZE o STATUS_INSUFFICIENT_RESOURCES.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | ntddstor.h (include Ntddstor.h) |