DEVPROPERTY-Struktur

  • Artikel

Beschreibt eine Eigenschaft für ein Softwaregerät.

Syntax

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

Member

  • CompKey
    Eine DEVPROPCOMPKEY-Struktur , die einen zusammengesetzten Schlüssel für eine Eigenschaft darstellt.

  • Typ
    Ein DEVPROPTYPE-Wert , der den Eigenschaftentyp angibt. Gültige DEVPROPTYPE-Werte werden aus Basiswerten DEVPROP_TYPE_ erstellt, die ggf. von einem logischen OR mit DEVPROP_TYPEMOD_-Werten geändert werden können.

    Hier sind DEVPROP_TYPE_ Werte möglich:

    Wert Bedeutung
    DEVPROP_TYPE_EMPTY 0x00000000

    Nichts, keine Eigenschaftsdaten
    DEVPROP_TYPE_NULL 0x00000001

    Null-Eigenschaftsdaten
    DEVPROP_TYPE_SBYTE 0x00000002

    8-Bit-Int (SBYTE)
    DEVPROP_TYPE_BYTE 0x00000003

    8-Bit unsigned int (BYTE)
    DEVPROP_TYPE_INT16 0x00000004

    16-Bit-Signiert int (SHORT)
    DEVPROP_TYPE_UINT16 0x00000005

    16-Bit unsigned int (USHORT)
    DEVPROP_TYPE_INT32 0x00000006

    32-Bit-Signiert int (LONG)
    DEVPROP_TYPE_UINT32 0x00000007

    32-Bit unsigned int (ULONG)
    DEVPROP_TYPE_INT64 0x00000008

    64-Bit-Int (LONG64)
    DEVPROP_TYPE_UINT64 0x00000009

    64-Bit unsigned int (ULONG64)
    DEVPROP_TYPE_FLOAT 0x0000000A

    32-Bit-Gleitkomma (FLOAT)
    DEVPROP_TYPE_DOUBLE 0x0000000B

    64-Bit-Gleitkomma (DOUBLE)
    DEVPROP_TYPE_DECIMAL 0x0000000C

    128-Bit-Daten (DEZIMAL)
    DEVPROP_TYPE_GUID 0x0000000D

    128-Bit Eindeutiger Bezeichner (GUID)
    DEVPROP_TYPE_CURRENCY 0x0000000E

    64-Bit-Wert für signierte Int-Währung (CURRENCY)
    DEVPROP_TYPE_DATE 0x0000000F

    date (DATE)
    DEVPROP_TYPE_FILETIME 0x00000010

    Dateizeit (FILETIME)
    DEVPROP_TYPE_BOOLEAN 0x00000011

    Boolescher 8-Bit-Wert (DEVPROP_BOOLEAN)
    DEVPROP_TYPE_STRING 0x00000012

    Null-beendete Zeichenfolge
    DEVPROP_TYPE_STRING_LIST DEVPROP_TYPE_STRING|DEVPROP_TYPEMOD_LIST

    Multi-SZ-Zeichenfolgenliste
    DEVPROP_TYPE_SECURITY_DESCRIPTOR 0x00000013

    Selbstrelative binäre SECURITY_DESCRIPTOR
    DEVPROP_TYPE_SECURITY_DESCRIPTOR_STRING 0x00000014

    Sicherheitsdeskriptorzeichenfolge (SDDL-Format)
    DEVPROP_TYPE_DEVPROPKEY 0x00000015

    Geräteeigenschaftsschlüssel (DEVPROPKEY)
    DEVPROP_TYPE_DEVPROPTYPE 0x00000016

    Geräteeigenschaftentyp (DEVPROPTYPE)
    DEVPROP_TYPE_BINARY DEVPROP_TYPE_BYTE|DEVPROP_TYPEMOD_ARRAY

    Benutzerdefinierte Binärdaten
    DEVPROP_TYPE_ERROR 0x00000017

    32-Bit-Win32-Systemfehlercode
    DEVPROP_TYPE_NTSTATUS 0x00000018

    32-Bit-NTSTATUS-Code
    DEVPROP_TYPE_STRING_INDIRECT 0x00000019

    Zeichenfolgenressource (@[Path\]<dllname>,-<strId>)

    Hier sind DEVPROP_TYPEMOD_ Werte möglich:

    Wert Bedeutung
    DEVPROP_TYPEMOD_ARRAY 0x00001000

    Array von Datenelementen mit fester Größe
    DEVPROP_TYPEMOD_LIST 0x00002000

    Liste der Datenelemente mit variabler Größe

  • BufferSize
    Die Größe der Eigenschaft in Buffer in Byte.

  • Buffer
    Der Puffer, der die Eigenschafteninformationen enthält.

    Dieser Member kann ein PBYTE-Typ sein, wenn MIDL_PASS definiert ist:

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

Anforderungen

Header

 Devpropdef.h (swdevice.h einschließen)

Weitere Informationen

SW_DEVICE_CREATE_INFO