EVT_POS_CX_DEVICE_REMOTE_RELEASE Rückruffunktion (poscx.h)
Der EVT_POS_CX_DEVICE_REMOTE_RELEASE Rückruf wird immer aufgerufen, wenn das Gerät losgelassen und ohne Besitzer übrig bleibt und dem Treiber ermöglicht, zusätzliche Aufgaben zu erledigen. Dieser Rückruf wird in der Regel nur mit mit dem Netzwerk verbundenen Geräten verwendet, die zusätzliche Logik für die Behandlung von Besitzerübergängen erfordern.
EVT_POS_CX_DEVICE_REMOTE_CLAIM und EVT_POS_CX_DEVICE_REMOTE_RELEASE Unterstützung für Remotegeräte hinzufügen, die ihre eigene Anspruchsemantik verarbeiten.
Syntax
EVT_POS_CX_DEVICE_REMOTE_RELEASE EvtPosCxDeviceRemoteRelease;
NTSTATUS EvtPosCxDeviceRemoteRelease(
[in] WDFDEVICE device,
[in] ULONG deviceInterfaceTag
)
{...}
Parameter
[in] device
Ein Handle zu einem Framework-Geräteobjekt, das das Gerät darstellt.
[in] deviceInterfaceTag
Ein Bezeichner, der verwendet wird, um anzugeben, welche Schnittstelle in einem Multifunktionsgerät freigegeben wird. Bei einem Gerät mit einer Schnittstelle sollte dieser Wert 0 sein.
Rückgabewert
Wenn der Vorgang erfolgreich ist, muss die Rückruffunktion STATUS_SUCCESS oder einen anderen Statuswert zurückgeben, für den NT_SUCCESS(Status) GLEICH WAHR ist.
Wenn der Treiber die Remotefreigabetransaktion nicht abschließen kann, sollte er STATUS_ACCESS_DENIED zurückgeben, sodass der Fehler bis zur Anwendung bubiert wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | poscx.h (include Poscx.h) |