EVT_WDF_CHILD_LIST_CREATE_DEVICE funzione di callback (wdfchildlist.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

Un autista del busEvtChildListCreateDevice funzione di callback degli eventi crea un oggetto dispositivo framework per un nuovo dispositivo che è stato enumerato dinamicamente.

Sintassi

EVT_WDF_CHILD_LIST_CREATE_DEVICE EvtWdfChildListCreateDevice;

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

Parametri

[in] ChildList

Handle per l'oggetto elenco figlio del framework specificato dal driver quando ha chiamato WdfChildListAddOrUpdateChildDescriptionAsPresent.

[in] IdentificationDescription

Puntatore a una copia della struttura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER specificata dal driver quando ha chiamato WdfChildListAddOrUpdateChildDescriptionAsPresent.

[in] ChildInit

Puntatore a una struttura WDFDEVICE_INIT.

Valore restituito

L'EvtChildListCreateDevice funzione di callback deve restituire STATUS_SUCCESS o un altro valore di stato per il quale NT_SUCCESS( stato) è uguale TRUE, se l'operazione ha esito positivo. In caso contrario, questa funzione deve restituire un valore di stato per il quale NT_SUCCESS( stato) è uguale a FALSE.

Se l'operazione non è riuscita, ma si ritiene che il driver debba riprovare più tardi e se il driver EvtChildListCreateDevice funzione di callback non ha chiamato WdfDeviceCreate, il driver può restituire STATUS_RETRY. Di conseguenza, il framework chiama nuovamente la EvtChildListCreateDevice funzione di callback in un secondo momento. Se il driver restituisce STATUS_RETRY più volte, il framework smetterà di chiamare la funzione di callback per il dispositivo in errore.

Osservazioni

Se un driver del bus usa 'enumerazione dinamica, può registrare un EvtChildListCreateDevice funzione di callback chiamando WdfFdoInitSetDefaultChildListConfig o WdfChildListCreate.

Dopo che un driver chiama WdfChildListAddOrUpdateChildDescriptionAsPresent o WdfChildListUpdateAllChildDescriptionsAsPresent, il framework chiama il evtChildListCreateDevice funzione di callback del driver. La funzione di callback deve chiamare WdfDeviceCreate per creare un oggetto dispositivo framework (PDO).

Prima di chiamare WdfDeviceCreate, il driver deve chiamare le funzioni fornite dal framework che inizializzano la struttura WDFDEVICE_INIT. Per altre informazioni su queste funzioni, vedere WDFDEVICE_INIT.

Per altre informazioni sulla chiamata di WdfDeviceCreate, vedere Creating a Framework Device Object.

Per altre informazioni sull'enumerazione dinamica, vedere Enumerating the Devices on a Bus.