EVT_SPB_CONTROLLER_OTHER回呼函式 (spbcx.h)

發行項
03/01/2024

SPB 控制器驅動程式的 EvtSpbControllerIoOther 事件回呼函式會處理其他事件回呼函式未處理的裝置 I/O 控制要求，或由 SPB 架構延伸模組 (SpbCx) 處理。

語法

EVT_SPB_CONTROLLER_OTHER EvtSpbControllerOther;

void EvtSpbControllerOther(
  [in] WDFDEVICE Controller,
  [in] SPBTARGET Target,
  [in] SPBREQUEST Request,
  [in] size_t OutputBufferLength,
  [in] size_t InputBufferLength,
  [in] ULONG IoControlCode
)
{...}

參數

[in] Controller

代表SPB控制器之架構裝置物件的 WDFDEVICE句柄。

[in] Target

這個 I/O 要求的目標 SPBTARGET 句柄。目標是連接至總線的周邊裝置或埠。 SPB 架構延伸模組 (SpbCx) 先前已將此句柄指派給 EvtSpbTargetConnect 回呼中開啟目標連線的目標。

[in] Request

I/O 要求的 SPBREQUEST 句柄。您的SPB控制器驅動程序必須完成此要求。如需詳細資訊，請參閱＜備註＞。

[in] OutputBufferLength

如果要求提供輸出緩衝區，則為輸出緩衝區的長度，以位元組為單位。

[in] InputBufferLength

如果要求提供輸入緩衝區，則為輸入緩衝區的長度，以位元組為單位。

[in] IoControlCode

要求的 I/O 控制項程式代碼 (IOCTL) 。這個值是SPB架構延伸模組 (SpbCx) 無法辨識的IOCTL。如需詳細資訊，請參閱＜備註＞。

傳回值

無

備註

SpbCx 會管理SPB控制器的 I/O 佇列。如果SPB控制器驅動程式註冊 EvtSpbControllerIoOther 回呼函式，當SpbCx不支援SpbCx的裝置 I/O 控件要求抵達控制器的 I/O 佇列時，SpbCx 會呼叫此函式。 Request 參數值是封裝此要求的句柄。 SPB 控制器驅動程式必須藉由執行要求的作業或傳回錯誤狀態來完成此要求。如果驅動程式不支援指定的IOCTL，驅動程式應該會傳回STATUS_NOT_SUPPORTED錯誤狀態。如需SpbCx支援的IOCTLs清單，請參閱 SpbCx I/O 控制代碼。

EvtSpbControllerIoOther 回呼可讓總線特定或驅動程式特定的命令分派至 SPB 控制器驅動程式作為 IOCTLs。例如，用戶端 (周邊驅動程式) 可能會使用這些 IOCTL 來協調總線特定的作業，例如與 SPI 總線上目標裝置進行全雙工數據交換。這類 IOCTL 受限於與 SpbCx 支援的 IOCTL 相同的流程控制。

EvtSpbControllerIoOther 回呼函式類似於 EvtIoDeviceControl，並以類似的方式處理 IOCTLs。如需 WDF 驅動程式如何處理 I/O 要求的一般資訊，請參閱 Framework 要求物件。

EvtSpbControllerIoOther 回呼不會傳回狀態值。相反地，SPB 控制器驅動程式會指出 I/O 要求的完成狀態中要求的作業狀態。

如果無法立即完成 I/O 要求，回呼函式應該會傳回，而不需要等待 SPB 控制器驅動程式完成處理要求。 SPB 控制器驅動程式稍後可以異步完成要求。

EvtSpbControllerIoOther 函式必須驗證其從使用者模式用戶端接收的 I/O 控制項要求中的參數值。對於 EvtSpbControllerIoOther 以外的所有 EvtSpbXxx 回呼函式，SpbCx 會在呼叫函式之前先驗證使用者模式參數。

若要註冊 EvtSpbControllerIoOther 回呼函式，請呼叫 SpbControllerSetIoOther 方法。

範例

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

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

EVT_SPB_CONTROLLER_OTHER  MyEvtSpbControllerIoOther;

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

_Use_decl_annotations_
VOID
  MyEvtSpbControllerIoOther(
    WDFDEVICE Controller,
    SPBTARGET Target,
    SPBREQUEST Request,
    size_t OutputBufferLength,
    size_t InputBufferLength,
    ULONG IoControlCode
    )
{ ... }

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