Funzione WdfDeviceInitSetPowerPageable (wdfdevice.h)

[Si applica solo a KMDF]

Il metodo WdfDeviceInitSetPowerPageable informa il risparmio energia che il driver deve essere in grado di accedere ai dati impaginabili durante la transizione del sistema tra uno stato di sospensione e lo stato di lavoro (S0).

Sintassi

void WdfDeviceInitSetPowerPageable(
  [in] PWDFDEVICE_INIT DeviceInit
);

Parametri

[in] DeviceInit

Puntatore fornito dal chiamante a una struttura WDFDEVICE_INIT .

Valore restituito

nessuno

Osservazioni

Se il driver di funzione o il driver del bus chiama WdfDeviceInitSetPowerPageable, il sistema garantisce che il dispositivo del file di paging sia nello stato funzionante (D0) quando il dispositivo del driver entra in uno stato di bassa potenza o torna allo stato di lavoro. In questo modo il driver può accedere ai file, al Registro di sistema e al pool di paging durante le transizioni di alimentazione del dispositivo.

Per impostazione predefinita, il framework consente l'accesso ai dati di paging per i driver di funzione. Il framework usa l'impostazione del dispositivo padre per ogni dispositivo figlio enumerato da un driver del bus, a meno che il driver del bus non chiami WdfDeviceInitSetPowerPageable o WdfDeviceInitSetPowerNotPageable per il dispositivo figlio. Se scrivi un driver del bus che chiama WdfDeviceInitSetPowerPageable per un dispositivo figlio, nessun driver nello stack del dispositivo figlio può chiamare WdfDeviceInitSetPowerNotPageable.

La chiamata a WdfDeviceInitSetPowerPageable o WdfDeviceInitSetPowerNotPageable da un driver di filtro non ha alcun effetto. Il framework usa l'impostazione specificata dal driver successivo inferiore.

La maggior parte dei driver non deve chiamare WdfDeviceInitSetPowerPageable o WdfDeviceInitSetPowerNotPageable. È invece consigliabile consentire al framework di usare l'impostazione predefinita appropriata per il driver. Tuttavia, il driver deve chiamare WdfDeviceInitSetPowerNotPageable se il driver fa parte di uno stack di driver che non deve accedere ai dati impaginabili durante le transizioni di alimentazione (ad esempio lo stack di archiviazione o lo stack di video) o se il driver è un driver bus che enumera i dispositivi che potrebbero essere dispositivi di archiviazione o video.

Se il driver chiama WdfDeviceInitSetPowerInrush, non deve chiamare WdfDeviceInitSetPowerPageable.

Il driver deve chiamare WdfDeviceInitSetPowerPageable prima di chiamare WdfDeviceCreate.

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

Esempio

L'esempio di codice seguente informa il risparmio energia che un driver deve essere in grado di accedere ai dati impaginabili mentre il sistema sta passando tra uno stato di sospensione e lo stato funzionante (S0).

WdfDeviceInitSetPowerPageable(DeviceInit);

Requisiti

Vedi anche

WdfDeviceInitSetPowerNotPageable