EVT_WDF_CHILD_LIST_DEVICE_REENUMERATED funzione di callback (wdfchildlist.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

La funzione di callback di un driver EvtChildListDeviceReenumerated consente al driver di approvare o annullare una rinumerazione di un dispositivo specificato.

Sintassi

EVT_WDF_CHILD_LIST_DEVICE_REENUMERATED EvtWdfChildListDeviceReenumerated;

BOOLEAN EvtWdfChildListDeviceReenumerated(
  [in]  WDFCHILDLIST ChildList,
  [in]  WDFDEVICE OldDevice,
  [in]  PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER OldAddressDescription,
  [out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER NewAddressDescription
)
{...}

Parametri

[in] ChildList

Handle per un oggetto elenco figlio del framework.

[in] OldDevice

Handle per un oggetto dispositivo framework.

[in] OldAddressDescription

Puntatore facoltativo a una struttura WDF_CHILD_ADDRESS_DESCRIPTION_HEADER che identifica una descrizione dell'indirizzo figlio o NULL. Se specificato, questa struttura contiene informazioni sull'indirizzo rilevanti prima della rinumerazione del dispositivo.

[out] NewAddressDescription

Puntatore facoltativo a una struttura WDF_CHILD_ADDRESS_DESCRIPTION_HEADER che identifica una descrizione dell'indirizzo figlio o NULL. Se specificato, la funzione di callback riempie questa struttura con nuove informazioni sull'indirizzo sul dispositivo.

Valore restituito

La funzione di callback EvtChildListDeviceReenumerated restituisce TRUE per approvare la rinumerazione o FALSE per annullarla.

Osservazioni

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

I driver del bus basati su framework possono ricevere una richiesta da un driver di funzione per rinumerare un particolare dispositivo figlio. Per altre informazioni su queste richieste, vedere Gestione delle richieste di enumerazione.

Il driver del bus EvtChildListDeviceReenumerated funzione di callback consente al driver di approvare o annullare la rinumerazione. Il parametro OldDevice identifica il dispositivo e il parametro ChildList identifica l'elenco figlio di cui il dispositivo è membro. Se la funzione di callback restituisce TRUE per approvare la rinumerazione o se la funzione di callback non esiste, il framework esegue le operazioni seguenti:

Rimuove l'oggetto dispositivo framework del dispositivo (identificato da OldDevice) ma mantiene la descrizione dell'identificazione del dispositivo.
Chiama il driver EvtChildListCreateDevice funzione di callback, passando la descrizione dell'identificazione salvata, in modo che la funzione di callback possa chiamare WdfDeviceCreate per creare un nuovo oggetto dispositivo framework.

Se il conducente del bus usa descrizioni degli indirizzi, la EvtChildListDeviceReenumerated funzione di callback riceve puntatori a due descrizioni degli indirizzi. Un punto alla descrizione dell'indirizzo associato all'oggetto dispositivo precedente. L'altro punta a una descrizione dell'indirizzo che la funzione di callback deve compilare con le informazioni che descrivono la posizione corrente del dispositivo.

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