Compartilhar via

IOCTL_HAL_GET_DEVICE_INFO

  • Artigo

Windows Mobile Not SupportedWindows Embedded CE Supported

9/8/2008

Este IOCTL fornece informações sobre os System-Parameters códigos informações (SPI) com suporte pela função SystemParametersInfo. Uma solicitação para recuperar os códigos SPI é feita pelo chamado a função OEMIoControl com IOCTL_HAL_GET_DEVICE_INFO.

Parâmetros

  • dwIoControlCode
    [no] Definido como IOCTL_HAL_GET_DEVICE_INFO para obter informações sobre os códigos SPI com suporte por SystemParametersInfo.

  • lpInBuf
    [no] Ponteiro para um DWORD que contém um dos códigos SPI_ * mostrados a seguinte tabela.

    Valor Descrição

    SPI_GETBOOTMENAME

    Retorna o nome BOOTME dispositivo (por exemplo, "CEPC53902"). Isso é sinônimo de usando PlatformID em IOCTL_HAL_GET_DEVICEID.

    SPI_GETGUIDPATTERN

    Retorna um padrão GUID Platform-specific.

    SPI_GETOEMINFO

    Retorna um seqüência de caracteres que contém o modelo número e nome do fabricante.

    SPI_GETPLATFORMMANUFACTURER

    Retorna um humanos-legível, não-NULL seqüência de caracteres de texto para o nome fabricante (OEM) plataforma.

    O seqüência de caracteres devem ser at least um caractere de comprimento e menor que 256 caracteres.

    SPI_GETPLATFORMNAME

    Retorna um humanos-legível, não-NULL seqüência de caracteres de texto para o nome versão plataforma (Produtos) (por exemplo, "CEPC").

    O seqüência de caracteres devem ser at least um caractere de comprimento e menor que 256 caracteres.

    Sinônimos com PresetID em IOCTL_HAL_GET_DEVICEID.

    SPI_GETPLATFORMTYPE

    Este parâmetro é substituído, começando com Windows Embedded CE 6.0. Use SPI_GETPROJECTNAME.

    Retorna um seqüência de caracteres especificando o tipo de dispositivo Windows Embedded CE .

    SPI_GETPLATFORMVERSION

    Atribui um número de versão um design OEM OS quando usado em conjunto com a SPI_GETPLATFORMTYPE IOCTL.

    Para obter mais informações, consulte Implementation of the SPI_GETPLATFORMVERSION IOCTL.

    Retorna {{CE_MAJOR_VER, CE_MINOR_VER}} regardless of plataforma.

    SPI_GETPROJECTNAME

    Retorna um projeto-seqüência de caracteres descrição (por exemplo, "CEBase").

    SPI_GETUUID

    Retorna hardware-exclusivo bytes para a plataforma. O tamanho de retorno esperado é o tamanho de uma GUID: 16 bytes.
  • nInBufsize
    [no] Tamanho, em bytes, de lpInBuf, que deve ser 4.

  • lpOutBuf
    [out] Ponteiro para o buffer de saída fornecido pelo chamador.

    Sua implementação camada (OAL) adaptação OEM deve local as informações solicitadas pelos parâmetros dwIoControlCode e lpInBuf Em lpOutBuf, Definir lpBytesReturned Para indicar o tamanho dos dados em lpOutbufe, em seguida, retornar TRUE.

    Se o tamanho das informações solicitadas ultrapassa a saída-tamanho do buffer especificado por nOutBufSize, especificar o exigido tamanho no lpBytesReturned.

    Então, chamar a função SetLastError com o sinalizador ERROR_INSUFFICIENT_BUFFER e retornar o valor FALSE. Isso permite que o aplicativo chamado para alocar espaço do buffer suficiente antes chamado IOCTL_HAL_GET_DEVICE_INFO.

  • nOutBufSize
    [no] Especifica o número máximo de bytes que podem ser retornados em lpOutBuf.

    O chamador define esse valor.

  • lpBytesReturned
    [no] Número de bytes retornados em lpOutBuf.

Valores Return

TRUE indica sucesso. FALSE indica falha.

Remarks

No Windows Embedded CE 6.0 IOCTL_HAL_GET_DEVICEID e IOCTL_HAL_GET_UUID são substituído e sua funcionalidade foi movido para IOCTL_HAL_GET_DEVICE_INFO.

Para obter mais informações, consulte Device Information IOCTL Unification.

Requisitos

Header pkfuncs.h
Windows Embedded CE Windows CE 3.0 and later

See Also

Reference

OEMIoControl

Concepts

Device Information IOCTL Unification
Providing System Information

Other Resources

SetLastError
SystemParametersInfo