EVT_WDF_CHILD_LIST_CREATE_DEVICE funzione di callback (wdfchildlist.h)

Articolo
08/08/2023

[Si applica solo a KMDF]

La funzione di callback dell'eventoEvtChildListCreateDevice di un driver del bus crea un oggetto dispositivo framework per un nuovo dispositivo enumerato in modo dinamico.

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 all'oggetto framework child-list specificato dal driver quando viene chiamato WdfChildListAddOrUpdateChildDescriptionAsPresent.

[in] IdentificationDescription

Puntatore a una copia della struttura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER specificata dal driver quando si chiama WdfChildListAddOrUpdateChildDescriptionAsPresent.

[in] ChildInit

Puntatore a una struttura WDFDEVICE_INIT .

Valore restituito

La funzione di callback EvtChildListCreateDevice deve restituire STATUS_SUCCESS o un altro valore di stato per il quale NT_SUCCESS(stato) è uguale a 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 in un secondo momento e se la funzione di callback EvtChildListCreateDevice del driver non ha chiamato WdfDeviceCreate, il driver può restituire STATUS_RETRY. Di conseguenza, il framework chiama nuovamente la funzione di callback EvtChildListCreateDevice . Se il driver restituisce STATUS_RETRY più volte, il framework smetterà di chiamare la funzione di callback per il dispositivo non riuscito.

Commenti

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

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

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

Per altre informazioni sulla chiamata a WdfDeviceCreate, vedere Creazione di un oggetto dispositivo Framework.

Per altre informazioni sull'enumerazione dinamica, vedere Enumerazione dei dispositivi in un bus.