PO_FX_DEVICE_POWER_NOT_REQUIRED_CALLBACK回呼函式 (wdm.h)

DevicePowerNotRequiredCallback 回呼例程會通知裝置驅動程式，裝置不需要保持 D0 電源狀態。

語法

PO_FX_DEVICE_POWER_NOT_REQUIRED_CALLBACK PoFxDevicePowerNotRequiredCallback;

void PoFxDevicePowerNotRequiredCallback(
  [in] PVOID Context
)
{...}

參數

[in] Context

裝置內容的指標。 設備驅動器會使用此內容來儲存裝置目前電源狀態的相關信息。 設備驅動器會在PO_FX_DEVICE結構的DeviceContext 成員中指定此指標，該PO_FX_DEVICE驅動程式用來向電源管理架構註冊裝置 (PoFx) 。 此內容與PoFx不透明。

傳回值

無

備註

當 PoFx 呼叫驅動程式的 DevicePowerNotRequiredCallback 例程時，驅動程式必須先決定是否要藉由將IRP_MN_SET_POWER要求向下傳送至裝置堆疊 ) 或維持在 D0 狀態，以起始轉換至低電源 Dx (狀態。 接下來，驅動程式必須呼叫 PoFxCompleteDevicePowerNotRequired 例程，通知 PoFx 驅動程式已完成 對 DevicePowerNotRequiredCallback 回 呼的回應。 驅動程式可以在 DevicePowerNotRequiredCallback 例程傳回之前或之後呼叫 PoFxCompleteDevicePowerNotRequired。

當裝置處於 D0 狀態，且裝置中元件的 Fx 狀態或作用中/閑置條件變更時，PoFx 會評估裝置是否可以進入低電源 Dx 狀態，或必須維持 D0 狀態。 如果裝置可以進入低電源 Dx 狀態，PoFx 會呼叫驅動程式的 DevicePowerNotRequiredCallback 例程。

如果裝置進入低電源 Dx 狀態以回應 DevicePowerNotRequiredCallback 回 呼，但 PoFx 稍後會判斷裝置必須進入 D0 狀態，PoFx 會呼叫驅動程式的 DevicePowerRequiredCallback 例程。 為了回應此呼叫，裝置必須進入 D0 狀態。

範例

若要定義 DevicePowerNotRequiredCallback 回 呼例程，您必須先提供函式宣告來識別您要定義的回呼例程類型。 Windows 提供一組驅動程式的回呼函式類型。 使用回呼函式類型宣告函式有助於 驅動程式的程式代碼分析、 靜態驅動程式驗證器 (SDV) ，以及其他驗證工具會尋找錯誤，而且這是撰寫 Windows 操作系統驅動程式的需求。

例如，若要定義名為MyDevicePowerNotRequiredCallback的 DevicePowerNotRequiredCallback 回呼例程，請使用 PO_FX_DEVICE_POWER_NOT_REQUIRED_CALLBACK 類型，如下列程式碼範例所示：

PO_FX_DEVICE_POWER_NOT_REQUIRED_CALLBACK MyDevicePowerNotRequiredCallback;

然後，實作回呼例程，如下所示：

_Use_decl_annotations_
VOID
  MyDevicePowerNotRequiredCallback(
    PVOID Context
    )
  {
      // Function body
  }

PO_FX_DEVICE_POWER_NOT_REQUIRED_CALLBACK函式類型定義於 Wdm.h 頭檔中。 若要在執行程式代碼分析工具時更精確地識別錯誤，請務必將 _Use_decl_annotations_ 註釋新增至函式定義。 批 _Use_decl_annotations_ 注可確保使用頭檔中套用至PO_FX_DEVICE_POWER_NOT_REQUIRED_CALLBACK函式類型的批註。 如需函式宣告需求的詳細資訊，請參閱 使用WDM驅動程式的函式角色類型來宣告函式。 如需 的相關信息 _Use_decl_annotations_，請參閱 標註函式行為。

規格需求

另請參閱

DevicePowerRequiredCallback

IRP_MN_SET_POWER

PO_FX_DEVICE

PoFxCompleteDevicePowerNotRequired

PoFxRegisterDevice