Freigeben über

EVT_POS_CX_DEVICE_REMOTE_RETAIN Rückruffunktion (poscx.h)

  • Artikel

Der EVT_POS_CX_DEVICE_REMOTE_RETAIN Rückruf wird immer aufgerufen, wenn PosCx versucht, einen Anspruch auf einem Netzwerkgerät zu halten und dem Treiber zusätzliche Arbeit zu ermöglichen. 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.

Syntax

EVT_POS_CX_DEVICE_REMOTE_RETAIN EvtPosCxDeviceRemoteRetain;

NTSTATUS EvtPosCxDeviceRemoteRetain(
  [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 Mehrfunktionsgerät aufbewahrt 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 Remote-Aufbewahrungstransaktion 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)