閱讀英文

共用方式為

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

初始化期間提供給 miniport 驅動程式之 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 開始提供。
目標平臺 普遍
標頭 portcls.h （包括 Portcls.h）
連結庫 Portcls.lib
IRQL PASSIVE_LEVEL

另請參閱

IInterruptSync

IResourceList

IResourceList：：NumberOfEntriesOfType