WDF_CHILD_LIST_CONFIG-Struktur (wdfchildlist.h)

[Gilt nur für KMDF]

Die WDF_CHILD_LIST_CONFIG-Struktur enthält Konfigurationsinformationen für eine Liste untergeordneter Geräte.

Syntax

typedef struct _WDF_CHILD_LIST_CONFIG {
  ULONG                                                   Size;
  ULONG                                                   IdentificationDescriptionSize;
  ULONG                                                   AddressDescriptionSize;
  PFN_WDF_CHILD_LIST_CREATE_DEVICE                        EvtChildListCreateDevice;
  PFN_WDF_CHILD_LIST_SCAN_FOR_CHILDREN                    EvtChildListScanForChildren;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COPY      EvtChildListIdentificationDescriptionCopy;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_DUPLICATE EvtChildListIdentificationDescriptionDuplicate;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP   EvtChildListIdentificationDescriptionCleanup;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE   EvtChildListIdentificationDescriptionCompare;
  PFN_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_COPY             EvtChildListAddressDescriptionCopy;
  PFN_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_DUPLICATE        EvtChildListAddressDescriptionDuplicate;
  PFN_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP          EvtChildListAddressDescriptionCleanup;
  PFN_WDF_CHILD_LIST_DEVICE_REENUMERATED                  EvtChildListDeviceReenumerated;
} WDF_CHILD_LIST_CONFIG, *PWDF_CHILD_LIST_CONFIG;

Member

Size

Die Größe (in Bytes) dieser Struktur.

IdentificationDescriptionSize

Die Größe der Identifizierungsbeschreibung jedes untergeordneten Elements in Byte. Weitere Informationen finden Sie unter WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER.

AddressDescriptionSize

Die Größe der Adressbeschreibung jedes untergeordneten Elements in Byte. Weitere Informationen finden Sie unter WDF_CHILD_ADDRESS_DESCRIPTION_HEADER.

EvtChildListCreateDevice

Ein Zeiger auf die EvtChildListCreateDevice-Ereignisrückruffunktion des Treibers. Diese Rückruffunktion ist erforderlich.

EvtChildListScanForChildren

Ein Zeiger auf die EvtChildListScanForChildren-Ereignisrückruffunktion des Treibers. Diese Rückruffunktion ist optional.

EvtChildListIdentificationDescriptionCopy

Ein Zeiger auf die EvtChildListIdentificationDescriptionCopy-Ereignisrückruffunktion des Treibers. Diese Rückruffunktion ist optional.

EvtChildListIdentificationDescriptionDuplicate

Ein Zeiger auf die EvtChildListIdentificationDescriptionDuplicate-Ereignisrückruffunktion des Treibers. Diese Rückruffunktion ist optional.

EvtChildListIdentificationDescriptionCleanup

Ein Zeiger auf die Ereignisrückruffunktion EvtChildListIdentificationDescriptionCleanup des Treibers. Diese Rückruffunktion ist optional.

EvtChildListIdentificationDescriptionCompare

Ein Zeiger auf die EvtChildListIdentificationDescriptionCompare-Ereignisrückruffunktion des Treibers. Diese Rückruffunktion ist optional.

EvtChildListAddressDescriptionCopy

Ein Zeiger auf die EvtChildListAddressDescriptionCopy-Ereignisrückruffunktion des Treibers. Diese Rückruffunktion ist optional.

EvtChildListAddressDescriptionDuplicate

Ein Zeiger auf die EvtChildListAddressDescriptionDuplicate-Ereignisrückruffunktion des Treibers. Diese Rückruffunktion ist optional.

EvtChildListAddressDescriptionCleanup

Ein Zeiger auf die EvtChildListAddressDescriptionCleanup-Ereignisrückruffunktion des Treibers. Diese Rückruffunktion ist optional.

EvtChildListDeviceReenumerated

Ein Zeiger auf die EvtChildListDeviceReenumerated-Ereignisrückruffunktion des Treibers. Diese Rückruffunktion ist optional.

Hinweise

Die WDF_CHILD_LIST_CONFIG-Struktur wird als Eingabe für die Methoden WdfFdoInitSetDefaultChildListConfig und WdfChildListCreate verwendet.

Um eine WDF_CHILD_LIST_CONFIG-Struktur zu initialisieren, muss der Treiber WDF_CHILD_LIST_CONFIG_INIT aufrufen.

Weitere Informationen zu untergeordneten Listen 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

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListErstellen

WdfFdoInitSetDefaultChildListConfig