Funzione WdfPdoInitAllocate (wdfpdo.h)

  • Articolo

[Si applica solo a KMDF]

Il metodo WdfPdoInitAllocate alloca una struttura di WDFDEVICE_INIT per un driver bus basato su framework, che il driver del bus usa quando segnala un nuovo dispositivo.

Sintassi

PWDFDEVICE_INIT WdfPdoInitAllocate(
  [in] WDFDEVICE ParentDevice
);

Parametri

[in] ParentDevice

Handle per un oggetto dispositivo framework che rappresenta il dispositivo padre del nuovo dispositivo. L'oggetto dispositivo framework deve rappresentare un oggetto dispositivo funzionale ( FDO).

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce un puntatore a una struttura WDFDEVICE_INIT allocata dal framework. In caso contrario, il metodo restituisce NULL.

Commenti

Se un driver del bus usa l'enumerazione statica, segnala un nuovo dispositivo in base a:

  1. Chiamata di WdfPdoInitAllocate per allocare una struttura WDFDEVICE_INIT .
  2. Chiamando i metodi di inizializzazione degli oggetti del dispositivo framework e i metodi di inizializzazione PDO del framework, in base alle esigenze, per inizializzare la struttura di WDFDEVICE_INIT. Se una chiamata a uno di questi metodi ha esito negativo, il driver deve chiamare WdfDeviceInitFree.
  3. Chiamata di WdfDeviceCreate per creare un oggetto dispositivo framework, fornendo la struttura WDFDEVICE_INIT inizializzata come input.
Per altre informazioni sull'enumerazione statica, vedere Enumerazione dei dispositivi in un bus.

Esempio

Per un esempio di codice che usa WdfPdoInitAllocate, vedere WdfFdoAddStaticChild.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfpdo.h (include Wdf.h)
Libreria Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL PASSIVE_LEVEL
Regole di conformità DDI AddPdoToStaticChildList(kmdf), DoubleDeviceInitFree(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf), PdoInitFreeDeviceCreateType2(kmdf), PdoInitFreeDeviceCreateType4(kmdf)

Vedi anche

WdfControlDeviceInitAllocate