GPIO_CLIENT_RECONFIGURE_INTERRUPT回呼函式 (gpioclx.h)

發行項
02/27/2024

CLIENT_ReconfigureInterrupt事件回呼函式會重新設定做為中斷輸入的一般用途 I/O (GPIO) 針腳。

語法

GPIO_CLIENT_RECONFIGURE_INTERRUPT GpioClientReconfigureInterrupt;

NTSTATUS GpioClientReconfigureInterrupt(
  [in] PVOID Context,
  [in] PGPIO_RECONFIGURE_INTERRUPTS_PARAMETERS ReconfigureParameters
)
{...}

參數

[in] Context

GPIO 控制器驅動程式裝置內容的指標。

[in] ReconfigureParameters

GPIO_RECONFIGURE_INTERRUPTS_PARAMETERS 結構的指標，指定如何重新設定 GPIO 中斷針腳。

傳回值

如果呼叫成功， CLIENT_ReconfigureInterrupt 函式會傳回STATUS_SUCCESS。否則，它會傳回適當的錯誤碼。

備註

GPIO 架構延伸模組 (GpioClx) 可能會呼叫 CLIENT_ReconfigureInterrupt 函式，以變更作為中斷輸入的 GPIO 針腳的中斷模式或中斷極性。

例如，如果 GPIO 控制器硬體未直接支持主動-兩個中斷，但可以設定為支持主動高和主動低階模式中斷，GpioClx 可以藉由呼叫 CLIENT_ReconfigureInterrupt 函式來模擬主動-兩個中斷針腳，以替代方式設定主動高低階模式中斷的 GPIO 針腳。如需使用中-兩個中斷的詳細資訊，請參閱 CONTROLLER_ATTRIBUTE_FLAGS 中的模擬ActiveBoth 旗標描述。

GpioClx 會根據CLIENT_QueryControllerBasicInformation 回呼函 式提供給 GpioClx 的裝置資訊，在 PASSIVE_LEVEL 或 DIRQL 呼叫 CLIENT_ReconfigureInterrupt 回呼函式。 CLIENT_QueryControllerBasicInformation函式會以CLIENT_CONTROLLER_BASIC_INFORMATION結構的形式提供裝置資訊。如果 MemoryMappedController 旗標位是在這個結構的 Flags 成員中設定，GpioClx 會在 DIRQL 呼叫 CLIENT_ReconfigureInterrupt 函式，這是 GpioClx 中 ISR 執行所在的 IRQL。否則，會在PASSIVE_LEVEL呼叫此函式。如需此旗標位的詳細資訊，請參閱選擇性和必要的 GPIO 回呼函式。

範例

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

例如，若要定義名為MyEvtGpioReconfigureInterrupt的CLIENT_ReconfigureInterrupt回呼函式，請使用 GPIO_CLIENT_RECONFIGURE_INTERRUPT 函式類型，如下列程式代碼範例所示：

GPIO_CLIENT_RECONFIGURE_INTERRUPT MyEvtGpioReconfigureInterrupt;

然後，實作您的回呼函式，如下所示：

_Use_decl_annotations_
NTSTATUS
  MyEvtGpioReconfigureInterrupt(
    PVOID Context,
    PGPIO_RECONFIGURE_INTERRUPTS_PARAMETERS ReconfigureParameters
    )
{ ... }

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