WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 結構 (wdfchildlist.h)

[僅適用於 KMDF]

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 結構是標頭結構,必須是每個識別描述結構的第一個成員。

語法

typedef struct _WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER {
  ULONG IdentificationDescriptionSize;
} WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER, *PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER;

成員

IdentificationDescriptionSize

驅動程式定義結構的大小,以位元組為單位,其中包含裝置識別資訊。

備註

若要初始化 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 結構,驅動程式應該呼叫 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

驅動程式為IdentificationDescriptionSize成員指定的值必須符合其WDF_CHILD_LIST_CONFIG結構中為IdentificationDescriptionSize成員指定的值。

識別描述結構是驅動程式定義的。 驅動程式必須將結構的大小儲存在 IdentificationDescriptionSize 成員中。 size 值必須包含這個標頭結構的大小。 例如,驅動程式可能會定義識別描述元,如下所示:

typedef struct _IEEE_1394_CHILD_ID_DESCRIPTION {
  WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER  IdHeader;
 WCHAR  VendorName[32];
 WCHAR  ModelName[32];
 LONG  UnitSpecId; 
 LONG  UnitSoftwareVersion;
} IEEE_1394_CHILD_ID_DESCRIPTION, *PIEEE_1394_CHILD_ID_DESCRIPTION;

若要設定此位址描述元的 IdentificationDescriptionSize 成員,驅動程式可以使用下列程式代碼:

IEEE_1394_CHILD_ID_DESCRIPTION ID_Description;
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT(&ID_Description,
                                                 sizeof(ID_Description));

如需識別描述的詳細資訊,請參閱 動態列舉

規格需求

需求
最小 KMDF 版本 1.0
標頭 wdfchildlist.h (包含 Wdf.h)

另請參閱

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_CONFIG