IOCTL_STORAGE_GET_MEDIA_SERIAL_NUMBER IOCTL (ntddstor.h)

  • Articolo

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

IRP_MJ_DEVICE_CONTROL

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)

Vedi anche

MEDIA_SERIAL_NUMBER_DATA