Funzione WdfPdoInitAllocate (wdfpdo.h)
[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:
- Chiamata di WdfPdoInitAllocate per allocare una struttura WDFDEVICE_INIT .
- 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.
- Chiamata di WdfDeviceCreate per creare un oggetto dispositivo framework, fornendo la struttura WDFDEVICE_INIT inizializzata come input.
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) |