Freigeben über

EVT_POS_CX_DEVICE_REMOTE_RETAIN Rückruffunktion (poscx.h)

  • Artikel

Der EVT_POS_CX_DEVICE_REMOTE_RETAIN Rückruf wird aufgerufen, wenn PosCx versucht, einen Anspruch auf einem Netzwerkgerät zu halten und dem Treiber zusätzliche Aufgaben zu ermöglichen. Dieser Rückruf wird in der Regel nur für mit dem Netzwerk verbundene Geräte verwendet, die zusätzliche Logik für die Behandlung von Besitzübergängen erfordern.

Syntax

EVT_POS_CX_DEVICE_REMOTE_RETAIN EvtPosCxDeviceRemoteRetain;

NTSTATUS EvtPosCxDeviceRemoteRetain(
  [in] WDFDEVICE device,
  [in] ULONG deviceInterfaceTag
)
{...}

Parameter

[in] device

Ein Handle für ein Framework-Geräteobjekt, das das Gerät darstellt.

[in] deviceInterfaceTag

Ein Bezeichner, mit dem angegeben wird, welche Schnittstelle in einem Multifunktionsgerät beibehalten wird. Für ein Gerät mit einer einzelnen 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) gleich TRUE ist.

Wenn der Treiber die Remoteaufbewahrungstransaktion nicht abschließen kann, sollte er STATUS_ACCESS_DENIED zurückgeben, damit der Fehler bis zur Anwendung angezeigt wird.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile poscx.h (einschließlich Poscx.h)