Fungsi NdisAllocateTimerObject (ndis.h)

Fungsi NdisAllocateTimerObject mengalokasikan dan menginisialisasi objek timer untuk digunakan dengan fungsi timer NdisXxx berikutnya.

Sintaks

NDIS_STATUS NdisAllocateTimerObject(
  [in]  NDIS_HANDLE                 NdisHandle,
  [in]  PNDIS_TIMER_CHARACTERISTICS TimerCharacteristics,
  [out] PNDIS_HANDLE                pTimerObject
);

Parameter

[in] NdisHandle

Handel NDIS yang diperoleh selama inisialisasi penelepon. Untuk informasi selengkapnya tentang mendapatkan handel NDIS, lihat Mendapatkan Handel Kumpulan.

[in] TimerCharacteristics

Penunjuk ke penelepon yang disediakan NDIS_TIMER_CHARACTERISTICS struktur yang menentukan karakteristik objek timer yang dialokasikan.

[out] pTimerObject

Penunjuk ke handel objek pengatur waktu NDIS yang disediakan NDIS untuk mengidentifikasi objek timer dalam panggilan berikutnya ke fungsi timer NdisXxx .

Nilai kembali

NdisAllocateTimerObject mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Objek timer berhasil dialokasikan.
NDIS_STATUS_RESOURCES	Alokasi gagal karena sumber daya yang tidak mencukup.
NDIS_STATUS_BAD_CHARACTERISTICS	Alokasi gagal karena informasi dalam struktur NDIS_TIMER_CHARACTERISTICS tidak valid.
NDIS_STATUS_FAILURE	Tidak ada nilai status sebelumnya yang berlaku.

Keterangan

Untuk menggunakan layanan timer, driver NDIS terlebih dahulu memanggil fungsi NdisAllocateTimerObject untuk menginisialisasi objek timer. Biasanya, NdisAllocateTimerObject dipanggil selama inisialisasi driver.

Untuk memulai timer, panggil fungsi NdisSetTimerObject . Panggilan ke NdisSetTimerObject menyisipkan objek timer dalam antrean timer sistem. Hanya satu instans objek timer tertentu yang dapat diantrekan pada saat tertentu.

Untuk membatalkan timer, panggil fungsi NdisCancelTimerObject . NdisCancelTimerObject menghapus antrean objek timer jika saat ini diantrekan.

Untuk membebaskan objek timer, Anda harus memanggil fungsi NdisFreeTimerObject .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_Timer_Function(ndis)

Lihat juga

NDIS_TIMER_CHARACTERISTICS

NdisCancelTimerObject

NdisFreeTimerObject

NdisSetTimerObject