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 Identifikationsbeschreibungsstruktur sein muss.

Syntax

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

Member

IdentificationDescriptionSize

Die Größe in Bytes 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_INIT aufrufen.

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

Identifikationsbeschreibungsstrukturen sind treiberdefiniert. Der Treiber muss die Größe der Struktur im Member "IdentificationDescriptionSize " speichern. Der Größenwert muss die Größe dieser Kopfzeilenstruktur 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 das IdentificationDescriptionSize-Element 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

   
KMDF-Mindestversion 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