EVT_POS_CX_DEVICE_REMOTE_CLAIM Rückruffunktion (poscx.h)
Der EVT_POS_CX_DEVICE_REMOTE_CLAIM Rückrufs wird aufgerufen, wenn das Gerät von nicht beansprucht zu beansprucht wechselt und dem Treiber ermöglicht, zusätzliche Aufgaben zu erledigen. Dieser Rückruf wird in der Regel nur bei mit dem Netzwerk verbundenen Geräten verwendet, die zusätzliche Logik für die Behandlung von Besitzü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_CLAIM EvtPosCxDeviceRemoteClaim;
NTSTATUS EvtPosCxDeviceRemoteClaim(
[in] WDFDEVICE device,
[in] ULONG deviceInterfaceTag
)
{...}
Parameter
[in] device
Ein Handle für ein Frameworkgerätobjekt, das das Gerät darstellt.
[in] deviceInterfaceTag
Ein Bezeichner, der verwendet wird, um anzugeben, welche Schnittstelle in einem Mehrfunktionsgerät beansprucht wird. Für ein 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 status Wert zurückgeben, für den NT_SUCCESS(status) true entspricht.
Wenn der Treiber die Remoteanspruchstransaktion nicht abschließen kann, sollte er STATUS_ACCESS_DENIED zurückgeben, damit der Fehler in die Anwendung übersprudelt.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | poscx.h (einschließlich Poscx.h) |