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

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

EVT_POS_CX_DEVICE_REMOTE_CLAIM と EVT_POS_CX_DEVICE_REMOTE_RELEASE は、独自の要求セマンティクスを処理するリモート デバイスのサポートを追加します。

構文

EVT_POS_CX_DEVICE_REMOTE_CLAIM EvtPosCxDeviceRemoteClaim;

NTSTATUS EvtPosCxDeviceRemoteClaim(
  [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 を含む)

こちらもご覧ください

EVT_POS_CX_DEVICE_REMOTE_RELEASE