Bagikan melalui

Fungsi WdfUsbTargetDeviceRetrieveCurrentFrameNumber (wdfusb.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Metode WdfUsbTargetDeviceRetrieveCurrentFrameNumber mengambil nomor bingkai USB saat ini.

Sintaks

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

Parameter

[in] UsbDevice

Handel ke objek perangkat USB yang diperoleh dari panggilan sebelumnya ke WdfUsbTargetDeviceCreateWithParameters.

[out] CurrentFrameNumber

Pointer ke lokasi yang menerima nomor bingkai USB 32-bit saat ini.

Nilai kembali

WdfUsbTargetDeviceRetrieveCurrentFrameNumber mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode ini dapat mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER
 Parameter yang tidak valid terdeteksi.
STATUS_UNSUCCESSFUL
 Nomor bingkai tidak tersedia, mungkin karena driver yang lebih rendah tidak menyediakan nomor bingkai.
 

Metode ini juga dapat mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Untuk informasi selengkapnya tentang metode WdfUsbTargetDeviceRetrieveCurrentFrameNumber dan target USB I/O, lihat Target I/O USB.

Contoh

Contoh kode berikut memanggil WdfUsbTargetDeviceRetrieveCurrentFrameNumber. Contohnya mendapatkan handel objek perangkat USB dari ruang konteks yang ditentukan driver.

ULONG  frameNumber;
PMY_DEVICE_CONTEXT  pMyDeviceContext;

pMyDeviceContext = GetDeviceContext(Device);

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

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Header wdfusb.h (termasuk Wdfusb.h)
Pustaka Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL <=DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Lihat juga

WdfUsbTargetDeviceCreateWithParameters