PcNewInterruptSync-Funktion (portcls.h)
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 |