EVT_SPB_CONTROLLER_OTHER回呼函式 (spbcx.h)

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 作業系統驅動程式的需求。

例如,若要定義名為 MyEvtSpbControllerIoOtherEvtSpbControllerIoOther回呼函式,請使用 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呼叫。

另請參閱

EvtIoDeviceControl

EvtSpbTargetConnect

SPBREQUEST

SPBTARGET

SpbControllerSetIoOther