次の方法で共有

WdfUsbTargetDeviceRetrieveCurrentFrameNumber 関数 (wdfusb.h)

  • [アーティクル]

[KMDF にのみ適用]

WdfUsbTargetDeviceRetrieveCurrentFrameNumber メソッドは、現在の USB フレーム番号を取得します。

構文

NTSTATUS WdfUsbTargetDeviceRetrieveCurrentFrameNumber(
  [in]  WDFUSBDEVICE UsbDevice,
  [out] PULONG       CurrentFrameNumber
);

パラメーター

[in] UsbDevice

WdfUsbTargetDeviceCreateWithParametersへの以前の呼び出しから取得された USB デバイス オブジェクトへのハンドル。

[out] CurrentFrameNumber

現在の 32 ビット USB フレーム番号を受け取る場所へのポインター。

戻り値

WdfUsbTargetDeviceRetrieveCurrentFrameNumber 、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、このメソッドは次のいずれかの値を返すことができます。

リターン コード 形容
STATUS_INVALID_PARAMETER
 無効なパラメーターが検出されました。
STATUS_UNSUCCESSFUL
 低いドライバーではフレーム番号が提供されないため、フレーム番号を使用できませんでした。
 

このメソッドは、他のNTSTATUS 値を返す場合もあります。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

備考

WdfUsbTargetDeviceRetrieveCurrentFrameNumber メソッドと USB I/O ターゲットの詳細については、「USB I/O ターゲットの」を参照してください。

例

次のコード例では、WdfUsbTargetDeviceRetrieveCurrentFrameNumber を呼び出します。 この例では、ドライバー定義のコンテキスト空間から USB デバイス オブジェクト ハンドルを取得します。

ULONG  frameNumber;
PMY_DEVICE_CONTEXT  pMyDeviceContext;

pMyDeviceContext = GetDeviceContext(Device);

status = WdfUsbTargetDeviceRetrieveCurrentFrameNumber(
                                              pMyDeviceContext->UsbTargetDevice,
                                              &frameNumber
                                              );

必要条件

要件 価値
ターゲット プラットフォーム の 万国
最小 KMDF バージョン 1.0
ヘッダー wdfusb.h (Wdfusb.h を含む)
ライブラリ Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。
IRQL <=DISPATCH_LEVEL
DDI コンプライアンス規則 を する DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExp usbKmdfIrql(kmdf) , usbKmdfIrql2(kmdf) , UsbKmdfIrqlExplicit(kmdf)

関連項目

WdfUsbTargetDeviceCreateWithParameters