PcNewInterruptSync 函式 (portcls.h)

  • 發行項

PcNewInterruptSync 函式會建立並初始化中斷同步處理物件。

語法

PORTCLASSAPI NTSTATUS PcNewInterruptSync(
  [out]          PINTERRUPTSYNC    *OutInterruptSync,
  [in, optional] PUNKNOWN          OuterUnknown,
  [in]           PRESOURCELIST     ResourceList,
  [in]           ULONG             ResourceIndex,
  [in]           INTERRUPTSYNCMODE Mode
);

參數

[out] OutInterruptSync

這個函式所建立之中斷同步處理對象的輸出指標。 此參數指向呼叫端配置的指標變數，函式會將參考輸出至新建立 的 IInterruptSync 物件。 為此參數指定有效的非 NULL 指標值。

[in, optional] OuterUnknown

需要匯總物件之物件的 IUnknown 介面指標。 除非需要匯總，否則請將此參數設定為 NULL。

[in] ResourceList

初始化期間提供給迷你埠驅動程式之 IResourceList 物件的指標。 埠驅動程式會檢查此資源清單，但不會加以修改。

[in] ResourceIndex

指定資源清單中的中斷資源索引。 如果 IResourceList：：NumberOfEntriesOfType 方法針對 CmResourceTypeInterrupt 類型傳回 N 的計數， ResourceIndex 必須是範圍 0 到 N-1 的值。

[in] Mode

指定多個ISR的處理方式。 將此參數設定為其中一個 INTERRUPTSYNCMODE 列舉值。 如需詳細資訊，請參閱接下來的＜備註＞一節。

傳回值

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

備註

Mode 參數設定為下表中的其中一個 INTERRUPTSYNCMODE 列舉值。

值 意義
InterruptSyncModeNormal 呼叫清單中的每個ISR，直到其中一個ISR傳回STATUS_SUCCESS為止。
InterruptSyncModeAll 不論各種ISR的傳回碼為何，都完全一次地呼叫清單中的每個ISR。
InterruptSyncModeRepeat 周游整個ISR清單，直到清單的行程發生時，清單中沒有ISR傳回STATUS_SUCCESS。
 

如需這三種模式的詳細描述，請參閱 中斷同步物件。

OutInterruptSync、OuterUnknown 和 ResourceList 參數會遵循 COM 對象的參考計數慣例。

規格需求

需求 值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 portcls.h (包含 Portcls.h)
程式庫 Portcls.lib
IRQL PASSIVE_LEVEL

另請參閱

IInterruptSync

IResourceList

IResourceList：：NumberOfEntriesOfType