EVT_SPB_CONTROLLER_OTHER回呼函式 （spbcx.h）
SPB 控制器驅動程式的 EvtSpbControllerIoOther 事件回呼函式會處理其他事件回呼函式或 SPB 架構延伸模組 （SpbCx） 未處理的裝置 I/O 控制要求。
語法
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
SPBREQUEST I/O 要求的句柄。 您的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 佇列時呼叫此函式。 要求 參數值是封裝此要求的句柄。 SPB 控制器驅動程式必須藉由執行要求的作業或傳回錯誤狀態來完成此要求。 如果驅動程式不支援指定的IOCTL，驅動程式應該會傳回STATUS_NOT_SUPPORTED錯誤狀態。 如需 SpbCx 支援的 IOCTL 清單，請參閱 SpbCx I/O 控制碼。
EvtSpbControllerIoOther 回呼可讓總線特定或驅動程式特定的命令以 IOCTLs 的形式分派至 SPB 控制器驅動程式。 例如，客戶端（周邊驅動程式）可能會使用這些 IOCTL 來協調總線特定作業，例如在 SPI 總線上與目標裝置進行全雙工數據交換。 這類 IOCTL 受限於與 SpbCx 所支援的 IOCTL 相同的流程控制。
EvtSpbControllerIoOther 回呼函式類似於 EvtIoDeviceControl，並以類似的方式處理 IOCTL。 如需 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的詳細資訊，請參閱 批注函式行為。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8 開始支援。 |
| 目標平臺 | 桌面 |
| 標頭 | spbcx.h |
| IRQL | 在 IRQL <= DISPATCH_LEVEL 呼叫。 |