Partilhar 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 de cliente USB poderá consultar seu número de série usando essa solicitação. Os 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 Irp-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 sizeof(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 para STATUS_INVALID_BUFFER_SIZE ou STATUS_INSUFFICIENT_RESOURCES.

Requisitos

Requisito Valor
Cabeçalho ntddstor.h (inclua Ntddstor.h)

Confira também

MEDIA_SERIAL_NUMBER_DATA