NdisMSynchronizeWithInterruptEx-Funktion (ndis.h)

Artikel
02/29/2024

Miniport-Treiber rufen die NdisMSynchronizeWithInterruptEx-Funktion auf, um die Ausführung einer vom Miniport-Treiber bereitgestellten Funktion mit der MiniportInterrupt-Funktion zu synchronisieren.

Syntax

BOOLEAN NdisMSynchronizeWithInterruptEx(
  [in] NDIS_HANDLE                            NdisInterruptHandle,
  [in] ULONG                                  MessageId,
  [in] MINIPORT_SYNCHRONIZE_INTERRUPT_HANDLER SynchronizeFunction,
  [in] PVOID                                  SynchronizeFunction,
  [in] PVOID                                  SynchronizeContext
);

Parameter

[in] NdisInterruptHandle

Ein Interrupthandle, das der Miniporttreiber bei einem vorherigen Aufruf des abgerufen hat. NdisMRegisterInterruptEx-Funktion .

[in] MessageId

Ein Interrupt mit Nachrichtensignal, mit dem der Treiber synchronisiert werden muss. Wenn NDIS keine Signalunterbrechungen für die Nachricht für den Treiber gewährt hat, ignoriert NDIS diesen Parameter. MessageId ist ein Index für die IO_INTERRUPT_MESSAGE_INFO_ENTRY Strukturen in einem IO_INTERRUPT_MESSAGE_INFO Struktur. NDIS übergibt einen Zeiger auf die zugeordnete IO_INTERRUPT_MESSAGE_INFO-Struktur am MessageInfoTable-Member , wenn der Treiber erfolgreich für MSI mit der NdisMRegisterInterruptEx-Funktion registriert wird.

[in] SynchronizeFunction

Der Einstiegspunkt des Fahrers MiniportSynchronizeInterrupt-Funktion .

[in] SynchronizeFunction

Der Einstiegspunkt des Fahrers MiniportSynchronizeInterrupt-Funktion .

[in] SynchronizeContext

Ein Zeiger auf einen vom Miniport-Treiber bestimmten Kontextbereich, der an die MiniportSynchronizeInterrupt-Funktion unter SynchronizeContext übergeben wird.

Rückgabewert

NdisMSynchronizeWithInterruptEx gibt den booleschen Wert zurück, den MiniportSynchronizeInterrupt zurückgibt.

Hinweise

Miniport-Treiber, die einen Interrupt bei NdisMRegisterInterruptEx registrieren, verwenden NdisMSynchronizeWithInterruptEx. Der Wert, den die MiniportSynchronizeInterrupt-Funktionsrückgaben werden auch von NdisMSynchronizeWithInterruptEx zurückgegeben. Dieser weitergegebene Wert stellt dem Aufrufer status bereit.

Jede Miniporttreiberfunktion, die Ressourcen mit einer anderen Treiberfunktion teilt, die bei DIRQL ausgeführt wird, muss NdisMSynchronizeWithInterruptEx verwenden, um den Zugriff auf diese Ressourcen zu synchronisieren. Die MiniportSynchronizeInterrupt-Funktion wird auch bei DIRQL ausgeführt, und die freigegebenen Ressourcen werden durch eine systemseitig zugewiesene Spinsperre geschützt. Daher werden die freigegebenen Ressourcen durch die MiniportInterrupt-Funktion und den Aufrufer vor dem gleichzeitigen Zugriff geschützt.

NdisMSynchronizeWithInterruptEx gibt die Systemdrehsperre frei und stellt die ursprüngliche IRQL des Aufrufers wieder her, bevor die Steuerung zurückgegeben wird.

Weitere Informationen zum Abrufen und Freigeben von NDIS-Spinsperren finden Sie unter Synchronisierung und Benachrichtigung in Netzwerktreibern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Universell
Header	ndis.h (include Ndis.h, Video.h)
Bibliothek	Ndis.lib
IRQL	<= DIRQL
DDI-Complianceregeln	NdisMDeregisterInterruptEx(ndis)