IOCTL_HAL_GET_DEVICEID
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este IOCTL retorna o atual estrutura DEVICE_ID atribuída ao dispositivo. Uma solicitação para recuperar o DEVICE_ID é feita pelo chamado a função KernelIoControl com IOCTL_HAL_GET_DEVICEID.
Este IOCTL está sendo substituído, começando com Windows Embedded CE 6.0. Sua funcionalidade foi integrado em IOCTL_HAL_GET_DEVICE_INFO. Para obter mais informações, consulte Device Information IOCTL Unification.
Parâmetros
- dwIoControlCode
[no] Definir como IOCTL_HAL_GET_DEVICEID para recuperar o DEVICE_ID estrutura.
- lpInBuf
[no] Não utilizados. Deve ser definido como NULL.
- nInBufSize
[no] Não utilizados. Deve ser definido como 0.
- lpOutBuf
[no] Definido para o endereço de um alocado DEVICE_ID estrutura.
- nOutBufSize
[no] Definido para o tamanho das DEVICE_ID estrutura.
lpBytesReturned
[no] Endereço de um DWORD que recebe o tamanho, em bytes, da estrutura de dados que contém informações de identificação de dispositivo.Este parâmetro é opcional. Se você não precisa esse valor, defina este parâmetro como NULL.
Valores Return
Se o sistema oferece suporte a IOCTL_HAL_GET_DEVICEID e os parâmetros estão corretos, isso retornará TRUE para o sucesso. Se não for fornecido suporte para IOCTL_HAL_GET_DEVICEID ou houver falha na solicitação, esse retorna FALSE. FALSE também será retornado ao consultar o ioctl para o tamanho correto estrutura de dados. Consulte a seção " Comentários " para obter mais informações.
Remarks
Este IOCTL permite que o chamador para obter o DEVICE_ID estrutura associado com o dispositivo e para determinar o tamanho da estrutura. É recomendável que você consulta o sistema para o tamanho estrutura para que você pode alocar o direito tamanho do buffer e, em seguida, get a real dispositivo DEVICE_ID estrutura de dados.
A consulta o tamanho estrutura
Alocar um DEVICE_ID estrutura e, em seguida, definir o dwSize valor para zero
Passar a DEVICE_ID estrutura para KernelIoControl Usando IOCTL_HAL_GET_DEVICEID.
O KernelIoControl chamar retornará FALSE e GetLastError retornará ERROR_INSUFFICIENT_BUFFER. O dwSize membro in a DEVICE_ID estrutura irá conter o número de bytes necessários para informações de identificação de dispositivo. Neste maiúsculas e minúsculas, o lpBytesReturned valor não está definido.
Para informações de identificação de dispositivo get
Alocar uma reserva grande o suficiente e, em seguida, chamar KernelIoControl Usando IOCTL_HAL_GET_DEVICEID.
Os dados serão copiados lpOutBuf. Se lpBytesReturned não é NULL, em seguida, esse endereço conterá o tamanho dos dados copiados para a reserva. Isso deve ser igual a dwSize parâmetro in a DEVICE_ID estrutura de dados.
Se esse processo é bem-sucedido, a função retorna TRUE. Se ocorrer um erro, essa função retorna FALSE e conjuntos GetLastError. Se GetLastError é igual a ERROR_INSUFFICIENT_BUFFER, o dwSize parâmetro não será definido para o tamanho necessário para o estrutura de dados.
Requisitos
| Header | pkfuncs.h |
| Windows Embedded CE | Windows CE 2.10 and later |
See Also
Reference
Concepts
Device Information IOCTL Unification
Identifying Devices Uniquely