OID_GEN_CO_GET_TIME_CAPS

Catatan

OID_GEN_CO_GET_TIME_CAPS sama dengan OID_GEN_GET_TIME_CAPS.

OID_GEN_CO_GET_TIME_CAPS OID meminta driver miniport untuk mengembalikan kemampuannya untuk melaporkan waktu lokal NIC yang diformat sebagai struktur GEN_GET_TIME_CAPS, yang didefinisikan sebagai berikut:

typedef struct _GEN_GET_TIME_CAPS{
    ULONG   Flags;
    ULONG   ClockPrecision;
} GEN_GET_TIME_CAPS, *PGEN_GET_TIME_CAPS;

Anggota struktur ini berisi informasi berikut:

Bendera
Bendera berikut dapat menjadi ORed bersama-sama. Semua bendera yang tidak ditentukan harus diatur ke nol.

READABLE_LOCAL_CLOCK
Ketika diatur, menunjukkan keberadaan jam yang dapat dibaca pada NIC. Bahkan tanpa jam perangkat keras seperti itu, driver miniport dapat menggunakan jam sistem dengan memanggil NdisGetCurrentSystemTime, selama melaporkan presisi yang benar di anggota ClockPrecision.

CLOCK_NETWORK_DERIVED
Ketika diatur, menunjukkan bahwa waktu lokal NIC berasal dari koneksi jaringan, dibandingkan dengan jam onboard yang berjalan bebas.

CLOCK_PRECISION
Ketika diatur, menunjukkan bahwa anggota ClockPrecision berisi informasi yang valid.

RECEIVE_TIME_INDICATION_CAPABLE
Ketika diatur, menunjukkan bahwa perangkat keras NIC dapat mencatat waktu lokal di mana ia menerima sel pertama PDU yang diterima dan bahwa driver miniport menyebarkan waktu terima ini untuk setiap PDU saat menunjukkan paket ke protokol.

TIMED_SEND_CAPABLE
Ketika diatur, menunjukkan bahwa NIC dapat menjadwalkan paket untuk transmisi sesuai dengan waktu setempat. Protokol dapat menggunakan NDIS_SET_PACKET_TIME_TO_SEND untuk mengatur tanda waktu TimeToSend di blok data out-of-band dari deskriptor paket. Mengatur tanda waktu tidak memengaruhi kapan paket benar-benar ditransmisikan; sebaliknya, tanda waktu digunakan untuk perekaman. Driver protokol dapat menggunakan tanda waktu untuk menentukan berapa lama waktu yang diperlukan untuk menyelesaikan pengiriman paket.

TIME_STAMP_CAPABLE
Ketika diatur, menunjukkan bahwa NIC dapat memberi stempel (di bidang yang sesuai dari paket keluar) waktu di mana byte pertama paket ditransmisikan dan bahwa NIC dapat mengambil waktu ini dari bidang yang sama dari paket masuk.

ClockPrecision
Menentukan presisi jam dalam bagian per juta. Agar informasi ini dianggap valid, bendera CLOCK_PRECISION harus diatur.

Keterangan

Driver miniport dapat memberikan dukungan untuk parameter waktu tertentu bahkan tanpa adanya jam lokal atau jaringan. Secara khusus, driver miniport dapat menggunakan jam sistem untuk menerima indikasi waktu, pengiriman berwak waktu, dan bahkan stempel waktu. Jam berbasis NIC lebih baik karena cenderung memberikan presisi yang lebih tinggi dan dapat diakses dengan latensi yang lebih rendah daripada jam sistem. Dalam semua kasus, driver miniport harus menentukan presisi jam yang digunakannya. Ini memungkinkan protokol untuk menentukan cara terbaik menggunakan dukungan waktu driver miniport.

Jika driver miniport melaporkan keberadaan jam yang dapat dibaca, driver harus siap untuk segera merespons kueri OID_GEN_GET_NETCARD_TIME. Respons driver miniport terhadap panggilan ini sangat penting waktu dan oleh karena itu harus sinkron.

Persyaratan

Versi: Windows Vista dan Header yang lebih baru: Ntddndis.h (sertakan Ndis.h)