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 con routine 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 l'alimentazione 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 power dispatch.

Valore restituito

nessuno

Requisiti

Vedi anche

KStrContextDispatch