WDF_CHILD_ADDRESS_DESCRIPTION_HEADER-Struktur (wdfchildlist.h)

[Gilt nur für KMDF]

Die WDF_CHILD_ADDRESS_DESCRIPTION_HEADER-Struktur ist eine Headerstruktur, die das erste Element jeder Adressbeschreibungsstruktur sein muss.

Syntax

typedef struct _WDF_CHILD_ADDRESS_DESCRIPTION_HEADER {
  ULONG AddressDescriptionSize;
} WDF_CHILD_ADDRESS_DESCRIPTION_HEADER, *PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER;

Member

AddressDescriptionSize

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

Hinweise

Um eine WDF_CHILD_ADDRESS_DESCRIPTION_HEADER-Struktur zu initialisieren, sollte Ihr Treiber WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT aufrufen.

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

Adressbeschreibungsstrukturen sind treiberdefiniert. Der Treiber muss die Strukturgröße im AddressDescriptionSize-Member speichern. Der Größenwert muss die Größe dieser Headerstruktur enthalten. Beispielsweise kann ein Treiber einen Adressdeskriptor wie folgt definieren:

typedef struct _IEEE_1394_CHILD_ADDRESS_DESCRIPTION {
  WDF_CHILD_ADDRESS_DESCRIPTION_HEADER  AddressHeader;
  //
  // Current bus generation
  //
  ULONG Generation;
} IEEE_1394_CHILD_ADDRESS_DESCRIPTION, *PIEEE_1394_CHILD_ADDRESS_DESCRIPTION;

Um das AddressDescriptionSize-Element für diesen Adressdeskriptor festzulegen, kann der Treiber den folgenden Code verwenden:

IEEE_1394_CHILD_ADDRESS_DESCRIPTION Addr_Description;
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT (&Addr_Description, 
                                           sizeof(Addr_Description));

Weitere Informationen zu Adressbeschreibungen 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_INIT

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_LIST_CONFIG