Compartilhar via

Estrutura DEVPROPERTY

  • Artigo

Descreve uma propriedade para um dispositivo de software.

Sintaxe

typedef struct _DEVPROPERTY {
  DEVPROPCOMPKEY CompKey;
  DEVPROPTYPE    Type;
  ULONG          BufferSize;
  PVOID          Buffer;
} DEVPROPERTY, *PDEVPROPERTY;

Membros

  • CompKey
    Uma estrutura DEVPROPCOMPKEY que representa uma chave composta para uma propriedade.

  • Tipo
    Um valor DEVPROPTYPE que indica o tipo de propriedade. Os valores DEVPROPTYPE válidos são construídos com base DEVPROP_TYPE_ valores, que podem ser modificados por um OR lógico com valores de DEVPROP_TYPEMOD_, conforme apropriado.

    Aqui estão possíveis valores de DEVPROP_TYPE_:

    Valor Significado
    DEVPROP_TYPE_EMPTY 0x00000000

    Nada, nenhum dado de propriedade
    DEVPROP_TYPE_NULL 0x00000001

    Dados da propriedade Null
    DEVPROP_TYPE_SBYTE 0x00000002

    SBYTE (entrada com sinal de 8 bits)
    0x00000003 DEVPROP_TYPE_BYTE

    BYTE (unsigned int) de 8 bits
    DEVPROP_TYPE_INT16 0x00000004

    Int com sinal de 16 bits (SHORT)
    DEVPROP_TYPE_UINT16 0x00000005

    Int sem sinal de 16 bits (USHORT)
    DEVPROP_TYPE_INT32 0x00000006

    Int com sinal de 32 bits (LONG)
    DEVPROP_TYPE_UINT32 0x00000007

    Int sem sinal de 32 bits (ULONG)
    0x00000008 DEVPROP_TYPE_INT64

    Int com sinal de 64 bits (LONG64)
    DEVPROP_TYPE_UINT64 0x00000009

    Int sem sinal de 64 bits (ULONG64)
    DEVPROP_TYPE_FLOAT 0x0000000A

    Float (ponto flutuante) de 32 bits
    DEVPROP_TYPE_DOUBLE 0x0000000B

    Ponto flutuante de 64 bits (DOUBLE)
    DEVPROP_TYPE_DECIMAL 0x0000000C

    Dados de 128 bits (DECIMAL)
    DEVPROP_TYPE_GUID 0x0000000D

    GUID (identificador exclusivo) de 128 bits
    DEVPROP_TYPE_CURRENCY 0x0000000E

    Valor de moeda int com sinal de 64 bits (CURRENCY)
    0x0000000F DEVPROP_TYPE_DATE

    date (DATE)
    0x00000010 DEVPROP_TYPE_FILETIME

    hora do arquivo (FILETIME)
    DEVPROP_TYPE_BOOLEAN 0x00000011

    Booliano de 8 bits (DEVPROP_BOOLEAN)
    DEVPROP_TYPE_STRING 0x00000012

    Cadeia de caracteres terminada em nulo
    DEVPROP_TYPE_STRING_LIST DEVPROP_TYPE_STRING|DEVPROP_TYPEMOD_LIST

    Lista de cadeias de caracteres de vários sz
    DEVPROP_TYPE_SECURITY_DESCRIPTOR 0x00000013

    SECURITY_DESCRIPTOR binários auto-relativos
    DEVPROP_TYPE_SECURITY_DESCRIPTOR_STRING 0x00000014

    Cadeia de caracteres do descritor de segurança (formato SDDL)
    DEVPROP_TYPE_DEVPROPKEY 0x00000015

    Chave de propriedade do dispositivo (DEVPROPKEY)
    0x00000016 DEVPROP_TYPE_DEVPROPTYPE

    Tipo de propriedade do dispositivo (DEVPROPTYPE)
    DEVPROP_TYPE_BINARY DEVPROP_TYPE_BYTE|DEVPROP_TYPEMOD_ARRAY

    Dados binários personalizados
    DEVPROP_TYPE_ERROR 0x00000017

    Código de erro do sistema Win32 de 32 bits
    DEVPROP_TYPE_NTSTATUS 0x00000018

    Código NTSTATUS de 32 bits
    DEVPROP_TYPE_STRING_INDIRECT 0x00000019

    Recurso de cadeia de caracteres (@[path\]<dllname>,-<strId>)

    Aqui estão possíveis valores de DEVPROP_TYPEMOD_:

    Valor Significado
    DEVPROP_TYPEMOD_ARRAY 0x00001000

    Matriz de elementos de dados de tamanho fixo
    DEVPROP_TYPEMOD_LIST 0x00002000

    Lista de elementos de dados de tamanho variável

  • BufferSize
    O tamanho em bytes da propriedade em Buffer.

  • Buffer
    O buffer que contém as informações da propriedade.

    Esse membro poderá ser um tipo PBYTE se MIDL_PASS estiver definido:

      #ifdef MIDL_PASS
        [size_is(BufferSize)] PBYTE Buffer;
    #else
        __field_bcount_opt(BufferSize) PVOID Buffer;
    #endif

Requisitos

parâmetro

 Devpropdef.h (inclua Swdevice.h)

Confira também

SW_DEVICE_CREATE_INFO