共用方式為

KsSetPowerDispatch 函式 (ks.h)

  • 發行項

設定驅動程式物件收到 IRP_MJ_POWER IRP 時要呼叫的電源分派函式。 只有在呼叫 KsDefaultDispatchPower 以分派或完成電源 IRP 時，這才有效。

這會影響將此對象標頭新增至具有要執行之電源分派例程的對象標頭清單。 此清單的標頭會由裝置標頭保留。 假設呼叫端先前已使用 KsAllocateDeviceHeader 在基礎 Device 物件上配置裝置標頭。

語法

KSDDKAPI VOID KsSetPowerDispatch(
  [in]           KSOBJECT_HEADER       Header,
  [in, optional] PFNKSCONTEXT_DISPATCH PowerDispatch,
  [in, optional] PVOID                 PowerContext
);

參數

[in] Header

指向先前由 KsAllocateObjectHeader 配置的標頭。

[in, optional] PowerDispatch

選擇性地包含將呼叫的電源分派函式，如果函式要從所呼叫的函式清單中移除，則為 NULL 。 此函式不得完成傳送的電源 IRP。 此函式的傳回值必須STATUS_SUCCESS。 如果目的只是操作此列表專案，則可以在執行此電源分派例程時呼叫 KsSetPowerDispatch。 操作其他清單專案可能會混淆目前的列舉。

[in, optional] PowerContext

選擇性地包含要傳遞至電源分派函式的內容參數。

傳回值

無

規格需求

需求 值
目標平台 Universal
標頭 ks.h (包含 Ks.h)
程式庫 Ks.lib

另請參閱

KStrContextDispatch