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 query sul 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 Irp-AssociatedIrp.SystemBuffer>.
Lunghezza del buffer di output
Parameters.DeviceIoControl.OutputBufferLength nella posizione dello stack I/O dell'IRP indica le dimensioni, in byte, del buffer, che devono essere almeno sizeof(MEDIA_SERIAL_NUMBER_DATA).
Blocco dello stato
Il campo Informazioni è impostato sulle dimensioni, in byte, dei dati restituiti. Il campo Stato può essere impostato su STATUS_SUCCESS o eventualmente su STATUS_INVALID_BUFFER_SIZE o STATUS_INSUFFICIENT_RESOURCES.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ntddstor.h (include Ntddstor.h) |