次の方法で共有

KsSetPowerDispatch 関数 (ks.h)

  • [アーティクル]

ドライバー オブジェクトが IRP_MJ_POWER IRP を受け取ったときに呼び出される電源ディスパッチ関数を設定します。 これは、電源 IRP のディスパッチまたは完了 KsDefaultDispatchPower が呼び出された場合にのみ有効です。

これは、このオブジェクト ヘッダーを、実行する電源ディスパッチ ルーチンを持つオブジェクト ヘッダーの一覧に追加する効果があります。 このリストの先頭はデバイス ヘッダーによって保持されます。 呼び出し元は、KsAllocateDeviceHeaderを使用して、基になるデバイス オブジェクトにデバイス ヘッダーを割り当てたことを前提としています。

構文

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

必要に応じて、電源ディスパッチ関数に渡すコンテキスト パラメーターを格納します。

戻り値

何一つ

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー ks.h (Ks.h を含む)
ライブラリ Ks.lib

関連項目

KStrContextDispatch