Compartilhar via


IOCTL_STORAGE_GET_MEDIA_SERIAL_NUMBER IOCTL (ntddstor.h)

Consulta o driver pai genérico USB para o número de série de um dispositivo USB. Se um dispositivo USB tiver uma interface de segurança de conteúdo CSM-1, um driver cliente USB poderá consultar seu número de série usando essa solicitação. Drivers de cliente USB que ajudam a implementar um sistema drm (gerenciamento de direitos digitais) podem usar essas informações para garantir que apenas clientes legítimos tenham acesso à propriedade intelectual digitalizada.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum.

Comprimento do buffer de entrada

Nenhum.

Buffer de saída

O driver retorna o número de série do dispositivo indicado em uma estrutura do tipo MEDIA_SERIAL_NUMBER_DATA no buffer em >AssociatedIrp.SystemBuffer.

Comprimento do buffer de saída

Parameters.DeviceIoControl.OutputBufferLength no local da pilha de E/S do IRP indica o tamanho, em bytes, do buffer, que deve ser pelo menos tamanho de(MEDIA_SERIAL_NUMBER_DATA).

Bloco de status

O campo Informações é definido como o tamanho, em bytes, dos dados retornados. O campo status pode ser definido como STATUS_SUCCESS ou possivelmente STATUS_INVALID_BUFFER_SIZE ou STATUS_INSUFFICIENT_RESOURCES.

Requisitos

Requisito Valor
cabeçalho ntddstor.h (include Ntddstor.h)

Consulte também

MEDIA_SERIAL_NUMBER_DATA