Freigeben über


WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER Struktur (wdfchildlist.h)

[Gilt nur für KMDF]

Die WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER-Struktur ist eine Kopfzeilenstruktur, die das erste Element jeder Identifikationsbeschreibung Struktur sein muss.

Syntax

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

Angehörige

IdentificationDescriptionSize

Die Größe einer vom Treiber definierten Struktur, die Geräteidentifikationsinformationen enthält.

Bemerkungen

Um eine WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER-Struktur zu initialisieren, sollte ihr Treiber WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INITaufrufen.

Der Wert, den der Treiber für das IdentificationDescriptionSize Member angibt, muss mit dem Wert übereinstimmen, den er für das IdentificationDescriptionSize Member in seiner WDF_CHILD_LIST_CONFIG Struktur angibt.

Identifikationsbeschreibungsstrukturen sind treiberdefiniert. Der Treiber muss die Größe der Struktur im IdentificationDescriptionSize Member speichern. Der Größenwert muss die Größe dieser Headerstruktur enthalten. Ein Treiber kann z. B. einen Identifikationsdeskriptor wie folgt definieren:

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;

Um den IdentificationDescriptionSize Member für diesen Adressdeskriptor festzulegen, kann der Treiber den folgenden Code verwenden:

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

Weitere Informationen zu Identifikationsbeschreibungen finden Sie unter dynamische Enumeration.

Anforderungen

Anforderung Wert
Minimale KMDF-Version 1.0
Header- wdfchildlist.h (include Wdf.h)

Siehe auch

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_CONFIG