次の方法で共有

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 を呼び出し、そのうちの 1 つがSTATUS_SUCCESS返されるまで呼び出します。
InterruptSyncModeAll の さまざまな ISR のリターン コードに関係なく、リスト内の各 ISR を 1 回だけ呼び出します。
InterruptSyncModeRepeat リスト内の ISR がSTATUS_SUCCESSを返さない一覧のトリップが発生するまで、ISR リスト全体を走査します。
 

これら 3 つのモードの詳細については、「割り込み同期オブジェクトの を参照してください。

OutInterruptSync、outerUnknown、および ResourceList パラメーターは、COM オブジェクト の参照カウント規則に従います。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー portcls.h (Portcls.h を含む)
ライブラリ Portcls.lib
IRQL PASSIVE_LEVEL

関連項目

IInterruptSync の

IResourceList の

IResourceList::NumberOfEntriesOfType