DEVPROPERTY 結構

  • 發行項

描述軟體裝置的屬性。

語法

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

成員

  • CompKey
    DEVPROPCOMPKEY 結構，表示屬性的複合索引鍵。

  • 類型
    表示屬性類型的 DEVPROPTYPE 值。 有效的 DEVPROPTYPE 值是從基底DEVPROP_TYPE_值建構而來，而邏輯 OR 可能會視需要修改DEVPROP_TYPEMOD_值。

    以下是可能的DEVPROP_TYPE_值：

    值 意義
    DEVPROP_TYPE_EMPTY 0x00000000

    Nothing，沒有屬性數據
    DEVPROP_TYPE_NULL 0x00000001

    Null 屬性數據
    DEVPROP_TYPE_SBYTE 0x00000002

    8 位帶正負號的 int (SBYTE)

    DEVPROP_TYPE_BYTE 0x00000003

    8 位無符號 int (BYTE)

    DEVPROP_TYPE_INT16 0x00000004

    16 位帶正負號的 int (SHORT)

    DEVPROP_TYPE_UINT16 0x00000005

    16 位無符號 int (USHORT)

    DEVPROP_TYPE_INT32 0x00000006

    32 位帶正負號的 int (LONG)

    DEVPROP_TYPE_UINT32 0x00000007

    32 位無符號 int (ULONG)

    DEVPROP_TYPE_INT64 0x00000008

    64 位帶正負號的 int (LONG64)

    DEVPROP_TYPE_UINT64 0x00000009

    64 位無符號 int (ULONG64)

    DEVPROP_TYPE_FLOAT 0x0000000A

    32 位浮點數 (FLOAT)

    DEVPROP_TYPE_DOUBLE 0x0000000B

    64 位浮點數 (DOUBLE)

    DEVPROP_TYPE_DECIMAL 0x0000000C

    128 位數據 (DECIMAL)

    DEVPROP_TYPE_GUID 0x0000000D

    128 位唯一標識碼 (GUID)

    DEVPROP_TYPE_CURRENCY 0x0000000E

    (CURRENCY) 64 位帶正負號的貨幣值
    DEVPROP_TYPE_DATE 0x0000000F

    date (DATE)

    DEVPROP_TYPE_FILETIME 0x00000010

    file time (FILETIME)

    DEVPROP_TYPE_BOOLEAN 0x00000011

    8 位布爾值 (DEVPROP_BOOLEAN)

    DEVPROP_TYPE_STRING 0x00000012

    以 Null 結尾的字串
    DEVPROP_TYPE_STRING_LIST DEVPROP_TYPE_STRING|DEVPROP_TYPEMOD_LIST

    多重 sz 字串清單
    DEVPROP_TYPE_SECURITY_DESCRIPTOR 0x00000013

    自我相對二進位SECURITY_DESCRIPTOR
    DEVPROP_TYPE_SECURITY_DESCRIPTOR_STRING 0x00000014

    SDDL 格式 (安全性描述元字串)

    DEVPROP_TYPE_DEVPROPKEY 0x00000015

    (DEVPROPKEY) 的裝置屬性金鑰
    DEVPROP_TYPE_DEVPROPTYPE 0x00000016

    (DEVPROPTYPE) 的裝置屬性類型
    DEVPROP_TYPE_BINARY DEVPROP_TYPE_BYTE|DEVPROP_TYPEMOD_ARRAY

    自訂二進位數據
    DEVPROP_TYPE_ERROR 0x00000017

    32 位 Win32 系統錯誤碼
    DEVPROP_TYPE_NTSTATUS 0x00000018

    32 位 NTSTATUS 程式代碼
    DEVPROP_TYPE_STRING_INDIRECT 0x00000019

    字串資源 (@[path\]<dllname>，-<strId>)

    以下是可能的DEVPROP_TYPEMOD_值：

    值 意義
    DEVPROP_TYPEMOD_ARRAY 0x00001000

    固定大小數據元素的陣列
    DEVPROP_TYPEMOD_LIST 0x00002000

    可變大小資料元素的清單

  • BufferSize
    Buffer 中屬性的大小，以位元組為單位。

  • Buffer
    包含屬性信息的緩衝區。

    如果已定義MIDL_PASS，此成員可以是 PBYTE 類型：

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

規格需求

標頭

 Devpropdef.h (包含 Swdevice.h)

另請參閱

SW_DEVICE_CREATE_INFO