Fungsi WdfUsbTargetDeviceRetrieveCurrentFrameNumber (wdfusb.h)

Artikel
02/27/2024

[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

Bagikan melalui