Funzione KsSetPowerDispatch (ks.h)
Imposta la funzione power dispatch da chiamare quando l'oggetto driver riceve un IRP_MJ_POWER IRP. Questa operazione è valida solo se KsDefaultDispatchPower viene chiamato per inviare o completare i runtime di integrazione di alimentazione.
Questo ha l'effetto di aggiungere questa intestazione di oggetto a un elenco di intestazioni di oggetto che hanno routine di power dispatch da eseguire. L'intestazione del dispositivo viene mantenuta dall'intestazione del dispositivo. Si supponga che il chiamante abbia precedentemente allocato un'intestazione del dispositivo nell'oggetto dispositivo sottostante con KsAllocateDeviceHeader.
Sintassi
KSDDKAPI VOID KsSetPowerDispatch(
[in] KSOBJECT_HEADER Header,
[in, optional] PFNKSCONTEXT_DISPATCH PowerDispatch,
[in, optional] PVOID PowerContext
);
Parametri
[in] Header
Punta a un'intestazione allocata in precedenza da KsAllocateObjectHeader.
[in, optional] PowerDispatch
Facoltativamente, contiene la funzione power dispatch che verrà chiamata o null se la funzione deve essere rimossa dall'elenco di funzioni chiamate. Questa funzione non deve completare la potenza inviata da IRP. Il valore restituito di questa funzione deve essere STATUS_SUCCESS. KsSetPowerDispatch può essere chiamato durante l'esecuzione di questa routine di power dispatch se lo scopo è modificare solo questa voce di elenco. La modifica di altre voci di elenco può confondere l'enumerazione corrente.
[in, optional] PowerContext
Facoltativamente, contiene il parametro di contesto da passare alla funzione di power dispatch.
Valore restituito
Nessuno
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | ks.h (include Ks.h) |
| libreria | Ks.lib |