DRIVER_PROXY_ENDPOINT_FUNCTION Rückruffunktion (wdm.h)

Der DRIVER_PROXY_ENDPOINT_FUNCTION Rückruf definiert die Funktionssignatur für eine Hot-Swappable-Endpunktfunktion im DriverProxy-System. Dies ist ein generischer Funktionszeigertyp, der jede Treiberfunktion darstellt, die über das Driver Hot-Swap Framework hot-swappable gemacht werden kann.

Syntax

DRIVER_PROXY_ENDPOINT_FUNCTION DriverProxyEndpointFunction;

VOID DriverProxyEndpointFunction()
{...}

Rückgabewert

Nichts

Bemerkungen

Endpunktfunktionen sind treiber implementierte Funktionen, die zur Laufzeit ersetzt werden können, ohne den Treiber entladen zu müssen. Das DriverProxy-System erstellt Wrapperfunktionen, die Aufrufe an die aktuelle Implementierung jeder Endpunktfunktion umleiten und die Hot-Swap-Funktionalität ermöglichen.

Dieser Rückruftyp dient als generischer Funktionszeiger für das DriverProxy-System. In der Praxis verfügen Endpunktfunktionen je nach ihrem spezifischen Zweck über unterschiedliche Signaturen, werden jedoch alle als DRIVER_PROXY_ENDPOINT_FUNCTION Zeiger in der DriverProxy-Infrastruktur behandelt.

In Driver Hot-Swap V2 werden Endpunktfunktionen während des Buildprozesses automatisch über Compiler- und Linkeranalyse ermittelt. Der Compiler identifiziert Funktionen, die hot-swappable sein sollten, und platziert Informationen dazu im .shsept Abschnitt der Binärdatei.

Wichtige Merkmale von Endpunktfunktionen:

• Sie können zur Laufzeit über das DriverProxy-System ersetzt werden.
• Sie werden über Wrapperfunktionen aufgerufen, die von IoGetDriverProxyWrapperFromEndpoint zurückgegeben werden.
• Sie müssen einer DriverProxy-Erweiterung zugeordnet sein, die von IoCreateDriverProxyExtension erstellt wurde.
• Der Austausch wird über die DriverProxy-Infrastruktur koordiniert, um die Threadsicherheit sicherzustellen.

Die tatsächlichen IRQL-Anforderungen für Endpunktfunktionen hängen von der implementierten spezifischen Funktion ab. Treiber sollten ihre Endpunktfunktionen entsprechend den IRQL-Einschränkungen ihrer beabsichtigten Verwendung entwerfen.

Anforderungen

Siehe auch

IoGetDriverProxyWrapperFromEndpoint

IofGetDriverProxyWrapperFromEndpoint

IoCreateDriverProxyExtension

DRIVER_PROXY_ENDPOINT_INFORMATION