EVT_WDF_CHILD_LIST_CREATE_DEVICE Rückruffunktion (wdfchildlist.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

DieEvtChildListCreateDevice Ereignisrückruffunktion eines Bustreibers erstellt ein Framework-Geräteobjekt für ein neues Gerät, das dynamisch aufgezählt wurde.

Syntax

EVT_WDF_CHILD_LIST_CREATE_DEVICE EvtWdfChildListCreateDevice;

NTSTATUS EvtWdfChildListCreateDevice(
  [in] WDFCHILDLIST ChildList,
  [in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription,
  [in] PWDFDEVICE_INIT ChildInit
)
{...}

Parameter

[in] ChildList

Ein Handle für das framework untergeordnete Listenobjekt, das vom Treiber beim Aufruf WdfChildListAddOrUpdateChildDescriptionAsPresentangegeben wurde.

[in] IdentificationDescription

Ein Zeiger auf eine Kopie der WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER Struktur, die der Treiber beim Aufruf WdfChildListAddOrUpdateChildDescriptionAsPresentangegeben hat.

[in] ChildInit

Ein Zeiger auf eine WDFDEVICE_INIT Struktur.

Rückgabewert

Die EvtChildListCreateDevice Rückruffunktion muss STATUS_SUCCESS oder einen anderen Statuswert zurückgeben, für den NT_SUCCESS(Status) TRUEentspricht, wenn der Vorgang erfolgreich ist. Andernfalls muss diese Funktion einen Statuswert zurückgeben, für den NT_SUCCESS(Status) FALSE-entspricht.

Wenn der Vorgang fehlgeschlagen ist, Sie aber glauben, dass der Treiber später erneut versuchen sollte, und wenn der Treiber EvtChildListCreateDevice Rückruffunktion nicht WdfDeviceCreateaufgerufen hat, kann der Treiber STATUS_RETRY zurückgeben. Daher ruft das Framework die EvtChildListCreateDevice Rückruffunktion später erneut auf. Wenn Ihr Treiber mehr als ein paar Mal STATUS_RETRY zurückgibt, wird das Framework den Aufruf der Rückruffunktion für das fehlerhafte Gerät beenden.

Bemerkungen

Wenn ein Bustreiber dynamische Enumeration verwendet, kann er eine EvtChildListCreateDevice Rückruffunktion registrieren, indem WdfFdoInitSetDefaultChildListConfig oder WdfChildListCreateaufgerufen wird.

Nachdem ein Treiber WdfChildListAddOrUpdateChildDescriptionAsPresent oder WdfChildListUpdateAllChildDescriptionsAsPresentaufgerufen hat, ruft das Framework die EvtChildListCreateDevice Rückruffunktion des Treibers auf. Die Rückruffunktion muss WdfDeviceCreate aufrufen, um ein Framework-Geräteobjekt (PDO) zu erstellen.

Vor dem Aufrufen WdfDeviceCreatemuss der Treiber vom Framework bereitgestellte Funktionen aufrufen, die die WDFDEVICE_INIT-Struktur initialisieren. Weitere Informationen zu diesen Funktionen finden Sie unter WDFDEVICE_INIT.

Weitere Informationen zum Aufrufen WdfDeviceCreatefinden Sie unter Creating a Framework Device Object.

Weitere Informationen zur dynamischen Aufzählung finden Sie unter Aufzählen der Geräte auf einem Bus-.