WdfInterruptReportActive 関数 (wdfinterrupt.h)

[KMDF にのみ適用]

WdfInterruptReportActive は、割り込みがアクティブであり、ドライバーが関連付けられている行の割り込み要求を処理する準備ができていることをシステムに通知します。

構文

void WdfInterruptReportActive(
  [in] WDFINTERRUPT Interrupt
);

パラメーター

[in] Interrupt

フレームワーク割り込みオブジェクトへのハンドル。

戻り値

なし

注釈

WdfInterruptReportActive 機能状態電源管理を実装するドライバーのみ。

ドライバーは、割り込みを作成した直後 WdfInterruptReportActive を呼び出す必要はありません。 ドライバーは、以前に WdfInterruptReportInactive 呼び出した後にのみ、WdfInterruptReportActive を呼び出す必要があります。

通常、ドライバーは、ComponentActiveConditionCallback ルーチンから WdfInterruptReportActive を呼び出します。または、State が 0 (完全にオンの F0 状態を示す) の場合は、ComponentIdleStateCallback から呼び出します。

ドライバーが Windows 8 より前のオペレーティング システムでこのメソッドを呼び出す場合は、フレームワークの検証ツールを エラーが報告されます。

詳細については、「機能電源状態 をサポートする」を参照してください。

例示

次の例は、ドライバーが KMDF ドライバーの ComponentIdleStateCallback ルーチンから WdfInterruptReportActive 呼び出す方法を示しています。 ドライバーは、WdfDeviceWdmAssignPowerFrameworkSettingsを呼び出すことによって、1 つのコンポーネントを登録します。

VOID
MyComponentIdleStateCallback(
    _In_ PVOID Context,
    _In_ ULONG Component,
    _In_ ULONG State
    )
{
    PFDO_DEVICE_DATA deviceData;
    PINTERRUPT_CONTEXT interruptContext;

    deviceData = FdoGetData((WDFDEVICE)Context);
    interruptContext = InterruptGetData(deviceData->Interrupt);

    switch (State) {
        case 0:
            if (interruptContext->ReportedInactive) {

                //
                // the interrupt was reported inactive earlier. We need to report active now.
                //
                WdfInterruptReportActive(deviceData->Interrupt);
                interruptContext->ReportedInactive = FALSE;

                //
                // Enable interrupt generation at hardware.
                // 
                WdfInterruptAcquireLock(deviceData->Interrupt);
                EnableInterruptInHardware();
                WdfInterruptReleaseLock(deviceData->Interrupt);

            }

        break;


    …

}

必要条件

要件	価値
サポートされる最小クライアント	Windows 8
ターゲット プラットフォーム の	普遍
最小 KMDF バージョン	1.11
ヘッダー	wdfinterrupt.h (Wdf.h を含む)
図書館	Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。
IRQL	<=DISPATCH_LEVEL
DDI コンプライアンス規則 を する	DriverCreate(kmdf)

こちらもご覧ください

WdfInterruptReportInactive