wdfchildlist.h-Header

Artikel
08/08/2023

Dieser Header wird von wdf verwendet. Weitere Informationen finden Sie unter

Windows-Treiberframework

wdfchildlist.h enthält die folgenden Programmierschnittstellen:

Functions


WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT Die WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT-Funktion initialisiert eine WDF_CHILD_ADDRESS_DESCRIPTION_HEADER-Struktur.
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT Die WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT-Funktion initialisiert eine WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER-Struktur.
WDF_CHILD_LIST_CONFIG_INIT Die WDF_CHILD_LIST_CONFIG_INIT-Funktion initialisiert eine WDF_CHILD_LIST_CONFIG-Struktur.
WDF_CHILD_LIST_ITERATOR_INIT Die WDF_CHILD_LIST_ITERATOR_INIT-Funktion initialisiert eine WDF_CHILD_LIST_ITERATOR-Struktur.
WDF_CHILD_RETRIEVE_INFO_INIT Die WDF_CHILD_RETRIEVE_INFO_INIT-Funktion initialisiert eine WDF_CHILD_RETRIEVE_INFO-Struktur.
WdfChildListAddOrUpdateChildDescriptionAsPresent Die WdfChildListAddOrUpdateChildDescriptionAsPresent-Methode fügt einer Liste von untergeordneten Elementen eine neue untergeordnete Beschreibung hinzu oder aktualisiert eine vorhandene untergeordnete Beschreibung.
WdfChildListBeginIteration Die WdfChildListBeginIteration-Methode bereitet das Framework für das Abrufen von Elementen aus einer angegebenen untergeordneten Liste vor.
WdfChildListBeginScan Die WdfChildListBeginScan-Methode bereitet eine angegebene Liste von untergeordneten Geräten vor, damit der Treiber die Informationen in der Liste aktualisieren kann.
WdfChildListCreate Die WdfChildListCreate-Methode erstellt eine untergeordnete Liste für ein angegebenes übergeordnetes Gerät.
WdfChildListEndIteration Die WdfChildListEndIteration-Methode verarbeitet Änderungen an einer angegebenen untergeordneten Liste.
WdfChildListEndScan Die WdfChildListEndScan-Methode verarbeitet Änderungen an einer angegebenen untergeordneten Liste.
WdfChildListGetDevice Die WdfChildListGetDevice-Methode gibt ein Handle an das Framework-Geräteobjekt zurück, das das übergeordnete Gerät einer angegebenen untergeordneten Liste darstellt.
WdfChildListRequestChildEject Die WdfChildListRequestChildEject-Methode informiert das Framework darüber, dass ein angegebenes Gerät aus seiner Dockingstation ausgeworfen werden soll.
WdfChildListRetrieveAddressDescription Die WdfChildListRetrieveAddressDescription-Methode sucht ein untergeordnetes Gerät mit einer angegebenen Identifikationsbeschreibung und ruft die Adressbeschreibung des Geräts ab.
WdfChildListRetrieveNextDevice Die WdfChildListRetrieveNextDevice-Methode durchläuft eine angegebene untergeordnete Liste und ruft das nächste untergeordnete Gerät ab, das den angegebenen Kriterien entspricht.
WdfChildListRetrievePdo Die WdfChildListRetrievePdo-Methode gibt ein Handle für das Framework-Geräteobjekt zurück, das einer angegebenen untergeordneten Beschreibung in einer untergeordneten Liste zugeordnet ist.
WdfChildListUpdateAllChildDescriptionsAsPresent Die WdfChildListUpdateAllChildDescriptionsAsPresent-Methode informiert das Framework darüber, dass alle untergeordneten Geräte in einer angegebenen untergeordneten Liste angeschlossen und verfügbar sind.
WdfChildListUpdateChildDescriptionAsMissing Die WdfChildListUpdateChildDescriptionAsMissing-Methode informiert das Framework darüber, dass ein angegebenes untergeordnetes Gerät derzeit nicht angeschlossen ist oder anderweitig nicht verfügbar ist.

Rückruffunktionen


EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP Die EvtChildListAddressDescriptionCleanup-Ereignisrückruffunktion eines Treibers gibt alle Speicherzuordnungen für eine Adressbeschreibung frei, die der EvtChildListAddressDescriptionDuplicate-Rückruffunktion des Treibers zugewiesen wurde.
EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_COPY Die EvtChildListAddressDescriptionCopy-Ereignisrückruffunktion eines Treibers kopiert eine untergeordnete Adressbeschreibung von einem angegebenen Speicherort an einen anderen.
EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_DUPLICATE Die EvtChildListAddressDescriptionDuplicate-Ereignisrückruffunktion eines Treibers dupliziert eine untergeordnete Adressbeschreibung.
EVT_WDF_CHILD_LIST_CREATE_DEVICE Die Ereignisrückruffunktion eines BustreibersEvtChildListCreateDevice erstellt ein Framework-Geräteobjekt für ein neues Gerät, das dynamisch aufgelistet wurde.
EVT_WDF_CHILD_LIST_DEVICE_REENUMERATED Die EvtChildListDeviceReenumerated-Ereignisrückruffunktion eines Treibers ermöglicht es dem Treiber, eine erneute Auflistung eines angegebenen Geräts zu genehmigen oder abzubrechen.
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP Die EvtChildListIdentificationDescriptionCleanup-Ereignisrückruffunktion eines Treibers gibt alle Speicherzuordnungen für eine Identifikationsbeschreibung frei, die der EvtChildListIdentificationDescriptionDuplicate-Rückruffunktion des Treibers zugewiesen wurde.
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE Die EvtChildListIdentificationDescriptionCompare-Ereignisrückruffunktion eines Treibers vergleicht eine untergeordnete Identifikationsbeschreibung mit einer anderen.
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COPY Die EvtChildListIdentificationDescriptionCopy-Ereignisrückruffunktion eines Treibers kopiert eine untergeordnete Identifikationsbeschreibung von einem angegebenen Speicherort an einen anderen.
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_DUPLICATE Die EvtChildListIdentificationDescriptionDuplicate-Ereignisrückruffunktion eines Treibers dupliziert eine beschreibung der untergeordneten Identifizierung.
EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN Die EvtChildListScanForChildren-Ereignisrückruffunktion eines Treibers muss alle vorhandenen untergeordneten Geräte melden.

Strukturen


WDF_CHILD_ADDRESS_DESCRIPTION_HEADER Die WDF_CHILD_ADDRESS_DESCRIPTION_HEADER-Struktur ist eine Headerstruktur, die das erste Element jeder Adressbeschreibungsstruktur sein muss.
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER Die WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER-Struktur ist eine Headerstruktur, die das erste Element jeder Identifikationsbeschreibungsstruktur sein muss.
WDF_CHILD_LIST_CONFIG Die WDF_CHILD_LIST_CONFIG-Struktur enthält Konfigurationsinformationen für eine Liste der untergeordneten Geräte.
WDF_CHILD_LIST_ITERATOR Die WDF_CHILD_LIST_ITERATOR-Struktur identifiziert den Typ der untergeordneten Geräte, die vom Framework abgerufen werden, wenn ein Treiber WdfChildListRetrieveNextDevice aufruft.
WDF_CHILD_RETRIEVE_INFO Die WDF_CHILD_RETRIEVE_INFO-Struktur enthält Informationen zu einem untergeordneten Gerät, das durch Aufrufen von WdfChildListRetrieveNextDevice oder WdfChildListRetrievePdo abgerufen wird.

Enumerationen


WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS Die WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS-Enumeration definiert Geräte status Werte, die das Framework in der WDF_CHILD_RETRIEVE_INFO-Struktur eines Treibers speichert.
WDF_RETRIEVE_CHILD_FLAGS Die WDF_RETRIEVE_CHILD_FLAGS-Enumeration definiert Flags, die ein Treiber vor dem Aufrufen von WdfChildListBeginIteration festlegen kann.