Compartilhar via


Identificadores de tipos de dados de propriedades

Um identificador de tipo de dados de propriedade é um valor do tipo DEVPROPTYPE que representa o formato de dados de uma propriedade. Em geral, um identificador de tipo de dados de propriedade é um OR bit a bit de um identificador de tipo de dados base e um modificador de tipo de dados de propriedade. Um identificador de tipo de dados de propriedade pode representar um único valor de tipo de dados base de comprimento fixo, um valor de tipo de dados base de comprimento variável, uma matriz de valores de tipo de dados base de comprimento fixo ou uma lista de valores de tipo de dados base de comprimento variável.

Os identificadores de tipo de dados base com suporte do sistema e modificadores de tipo de dados de propriedade são definidos em Devpropdef.h.

O Windows impõe os seguintes requisitos em identificadores de tipo de dados de propriedade:

  • O identificador de tipo de dados base é um dos identificadores DEVPROP_TYPE_Xxx .

  • Se o identificador de tipo de dados base for DEVPROP_TYPE_EMPTY ou DEVPROP_TYPE_NULL, o identificador de tipo de dados de propriedade não poderá incluir um modificador de tipo de dados de propriedade.

  • Se o identificador de tipo de dados de propriedade incluir um modificador de tipo de dados de propriedade, o modificador de tipo de dados de propriedade será um dos identificadores DEVPROP_TYPEMOD_Xxx .

  • O modificador de tipo de dado DEVPROP_TYPEMOD_ARRAY só pode ser combinado com os tipos de dados base de comprimento fixo.

  • O modificador de tipo de dados de propriedade DEVPROP_TYPEMOD_LIST só pode ser combinado com os tipos de dados base de comprimento variável.

Além de impor requisitos em identificadores de tipo de dados de propriedade, o Windows também impõe requisitos de valor de propriedade que dependem do tipo de dados de propriedade.

As funções de propriedade que recuperam e definem um valor de propriedade aceitam um parâmetro PropertyType. Para as funções que recuperam um valor de propriedade, PropertyType é um parâmetro de saída que recebe o identificador de tipo de dados de propriedade para uma propriedade. Para as funções que definem um valor de propriedade, PropertyType é um parâmetro de entrada que fornece o identificador de tipo de dados de propriedade para uma propriedade de dispositivo.

Para obter mais informações, consulte Acessar propriedades.