DXGK_GRAPHICSPOWER_REGISTER_OUTPUT 構造体 (d3dkmthk.h)

共有電源コンポーネントの管理に使用される出力データを含む構造体。

構文

typedef struct _DXGK_GRAPHICSPOWER_REGISTER_OUTPUT {
  PVOID                                  DeviceHandle;
  DEVICE_POWER_STATE                     InitialGrfxPowerState;
  PDXGK_SET_SHARED_POWER_COMPONENT_STATE SetSharedPowerComponentStateCb;
  PDXGK_GRAPHICSPOWER_UNREGISTER         UnregisterCb;
} DXGK_GRAPHICSPOWER_REGISTER_OUTPUT, *PDXGK_GRAPHICSPOWER_REGISTER_OUTPUT;

メンバー

DeviceHandle

グラフィックス デバイスへのコールバックを行うときに指定する必要がある不透明なハンドル。

InitialGrfxPowerState

内部 IOCTL 処理時に DeviceHandle によって表されるグラフィックス デバイスの電源状態。 この InitialGrfxPowerState の IOCTL 呼び出しと解析は、 PowerNotificationCb コールバックも保護するミューテックスによって保護される必要があります。

SetSharedPowerComponentStateCb

指定した電源コンポーネントがアクティブかどうかを示すコールバック。 コンポーネントのインデックスは、ドライバーの初期化時にコンポーネントが示されたときにグラフィックス ドライバーによって使用されるインデックスと一致する必要があり、コンポーネントは共有電源コンポーネントの種類のいずれかである必要があります。 このコールバックを使用して、このグラフィックス デバイスのこのドライバーによって既に設定されている状態を設定する場合、呼び出しは無効になります。

コンポーネントをアクティブに設定すると、このコールバックが返される前に、グラフィックス ドライバーに同期的に通知されます。 このコールバックは、 = APC_LEVELから <呼び出す必要があります。 デバイスが削除されていて、 RemovalNotificationCb がまだ呼び出されていない場合、またはグラフィックス アダプターが実行されていない場合、この呼び出しは STATUS_DEVICE_REMOVED で失敗する可能性があります。 「PDXGK_SET_SHARED_POWER_COMPONENT_STATE」を参照してください。

UnregisterCb

グラフィックス ドライバーに自身の登録を解除するためのコールバック。 すべての共有電源コンポーネントはアクティブではなくなります。 システムは、新しいアクティブな状態が FALSE であるすべてのアクティブな共有電源コンポーネントに対して SetSharedPowerComponentStateCb が呼び出されたかのように動作します。 戻ると、以前に指定したコールバックを使用できなくなります。 このコールバックは、 = APC_LEVELから <呼び出す必要があります。 「PDXGK_GRAPHICSPOWER_UNREGISTER」を参照してください。

要件