EVT_POS_CX_DEVICE_REMOTE_RETAIN コールバック関数 (poscx.h)

EVT_POS_CX_DEVICE_REMOTE_RETAIN コールバックは、PosCx がネットワーク デバイス上の要求を保持しようとしたときに呼び出され、ドライバーが追加の作業を行うことができます。 このコールバックは、通常、所有権の遷移を処理するための追加のロジックを必要とするネットワークに接続されたデバイスでのみ使用されます。

構文

EVT_POS_CX_DEVICE_REMOTE_RETAIN EvtPosCxDeviceRemoteRetain;

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

パラメーター

[in] device

デバイスを表すフレームワーク デバイス オブジェクトへのハンドル。

[in] deviceInterfaceTag

多機能デバイスに保持されているインターフェイスを指定するために使用される識別子。 シングル インターフェイス デバイスの場合、この値は 0 にする必要があります。

戻り値

操作が成功した場合、コールバック関数は、NT_SUCCESS(status) が TRUE であるSTATUS_SUCCESSまたは別の状態値を返す必要があります。

ドライバーがリモート保持トランザクションを完了できない場合は、エラーがアプリケーションにバブル アップするように、STATUS_ACCESS_DENIEDを返す必要があります。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	poscx.h (Poscx.h を含む)