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 にする必要があります。
戻り値
操作が成功した場合、コールバック関数は、STATUS_SUCCESSまたは NT_SUCCESS(status) が TRUE の別の状態値を返す必要があります。
ドライバーがリモート要求トランザクションを完了できない場合は、エラーがアプリケーションにバブル アップするように、STATUS_ACCESS_DENIEDを返す必要があります。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | ウィンドウズ |
ヘッダー | poscx.h (Poscx.h を含む) |