WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER-Struktur (wdfchildlist.h)

  • Artikel

[Gilt nur für KMDF]

Die WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER-Struktur ist eine Headerstruktur, 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 einer vom Treiber definierten Struktur in Bytes, die Geräteidentifikationsinformationen enthält.

Hinweise

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 den IdentificationDescriptionSize-Member 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 IdentificationDescriptionSize-Member speichern. Der Größenwert muss die Größe dieser Headerstruktur enthalten. Beispielsweise kann ein Treiber 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 Identifizierungsbeschreibungen finden Sie unter Dynamische Enumeration.

Anforderungen

Anforderung Wert
KMDF-Mindestversion 1.0
Kopfzeile wdfchildlist.h (include Wdf.h)

Weitere Informationen

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_CONFIG