PcNewInterruptSync-Funktion (portcls.h)

  • Artikel

Die PcNewInterruptSync-Funktion erstellt und initialisiert ein Interruptsynchronisierungsobjekt.

Syntax

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

Parameter

[out] OutInterruptSync

Ausgabezeiger für das von dieser Funktion erstellte Interruptsynchronisierungsobjekt. Dieser Parameter verweist auf eine vom Aufrufer zugeordnete Zeigervariable, in die die Funktion einen Verweis auf das neu erstellte IInterruptSync-Objekt ausgibt. Geben Sie einen gültigen Zeigerwert ohne NULL für diesen Parameter an.

[in, optional] OuterUnknown

Zeiger auf die IUnknown-Schnittstelle eines Objekts, das das Objekt aggregieren muss. Legen Sie diesen Parameter auf NULL fest, sofern keine Aggregation erforderlich ist.

[in] ResourceList

Zeiger auf das IResourceList-Objekt , das während der Initialisierung für den Miniporttreiber bereitgestellt wurde. Der Porttreiber überprüft diese Ressourcenliste, ändert sie jedoch nicht.

[in] ResourceIndex

Gibt den Index der Interruptressource in der Ressourcenliste an. Wenn die IResourceList::NumberOfEntriesOfType-Methode eine Anzahl von N für den Typ CmResourceTypeInterrupt zurückgibt, muss ResourceIndex ein Wert im Bereich von 0 bis N-1 sein.

[in] Mode

Gibt an, wie mehrere ISRs behandelt werden. Legen Sie diesen Parameter auf einen der INTERRUPTSYNCMODE-Enumerationswerte fest. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

PcNewInterruptSync gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben.

Hinweise

Der Parameter Mode ist auf einen der INTERRUPTSYNCMODE-Enumerationswerte in der folgenden Tabelle festgelegt.

Wert Bedeutung
InterruptSyncModeNormal Rufen Sie jede ISR in der Liste auf, bis einer von ihnen STATUS_SUCCESS zurückgibt.
InterruptSyncModeAll Rufen Sie jede ISR in der Liste genau einmal auf, unabhängig von den Rückgabecodes der verschiedenen ISRs.
InterruptSyncModeRepeat Durchlaufen Sie die gesamte ISR-Liste, bis eine Reise durch die Liste erfolgt, bei der kein ISR in der Liste STATUS_SUCCESS zurückgibt.
 

Ausführliche Beschreibungen dieser drei Modi finden Sie unter Unterbrechen von Synchronisierungsobjekten.

Die Parameter OutInterruptSync, OuterUnknown und ResourceList folgen den Referenzzählungskonventionen für COM-Objekte.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 2000.
Zielplattform Universell
Header portcls.h (portcls.h einschließen)
Bibliothek Portcls.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

IInterruptSync

IResourceList

IResourceList::NumberOfEntriesOfType