OID_WAN_CO_GET_INFO

OID OID_WAN_CO_GET_INFO meminta driver miniport untuk mengembalikan informasi yang berlaku untuk semua koneksi virtual (VC) pada NIC-nya. Informasi ini dikembalikan dalam struktur NDIS_WAN_CO_INFO, yang didefinisikan sebagai berikut.

    typedef struct _NDIS_WAN_CO_INFO {
         OUT ULONG MaxFrameSize;
         OUT ULONG MaxSendWindow;
         OUT ULONG FramingBits;
         OUT ULONG DesiredACCM;
    } NDIS_WAN_CO_INFO, *PNDIS_WAN_CO_INFO;

Anggota struktur ini berisi informasi berikut:

MaxFrameSize
Menentukan ukuran bingkai maksimum untuk paket bersih apa pun yang dapat dikirim dan diterima driver miniport. Nilai ini harus mengecualikan overhead pembingkaian driver miniport sendiri dan/atau overhead PPP HDLC. Biasanya nilai ini sekitar 1500.

Namun, semua driver miniport CoNDIS WAN harus menggunakan MaxFrameSize internal yang 32 byte lebih besar dari nilai yang mereka kembalikan untuk OID ini. Misalnya, driver miniport CoNDIS WAN yang mengembalikan 1500 untuk OID ini harus menerima dan mengirim hingga 1532 secara internal. Driver miniport seperti itu dapat dengan mudah mendukung bridging di masa depan dan protokol tambahan.

MaxSendWindow
Menentukan jumlah maksimum paket luar biasa yang dapat ditangani driver miniport CoNDIS WAN pada VC. Anggota ini harus diatur ke setidaknya satu.

Driver NDISWAN menggunakan nilai anggota ini sebagai batas berapa banyak paket yang dikirimkannya dalam permintaan pengiriman ke fungsi MiniportCoSendPackets driver miniport sebelum NDISWAN menahan pengiriman paket. Paket-paket ini diantrekan sampai driver miniport menyelesaikan pengiriman yang luar biasa. Driver miniport dapat menyesuaikan nilai ini secara dinamis dan berdasarkan per VC menggunakan anggota SendWindow dalam struktur WAN_CO_LINKPARAMS yang diteruskan driver miniport ke NdisMCoIndicateStatus. NDISWAN menggunakan nilai SendWindow saat ini sebagai batas pengiriman yang terutang. Jika driver miniport mengatur SendWindow ke nol, NDISWAN harus berhenti mengirim paket untuk VC tertentu. Artinya, driver miniport menentukan bahwa jendela kirim dimatikan, yang, berlaku, menentukan bahwa itu tidak dapat menerima paket apa pun dari NDISWAN.

Karena driver miniport CoNDIS WAN harus mengantre paket secara internal, nilai MaxSendWindow secara teoritis maks( ULONG). Namun, nilai yang ditentukan driver ini harus mencerminkan kecepatan tautan atau kemampuan perangkat keras NIC. Misalnya, jika NIC driver miniport selalu memiliki ruang untuk setidaknya empat paket, driver miniport mengatur MaxSendWindow ke empat sehingga paket masuk ke MiniportCoSendPackets dapat segera ditempatkan pada perangkat keras.

FramingBits
Nilai 32-bit yang menentukan bitmask yang menentukan jenis pembingkaian yang didukung driver miniport. Driver miniport dapat menentukan kombinasi nilai berikut, menggunakan operator OR biner:

RAS_FRAMING
Atur hanya jika driver miniport dapat mendeteksi pembingkaian RAS yang lebih lama. Hanya driver warisan yang mendukung pembingkaian RAS sebelumnya yang mengatur bendera ini.

RAS_COMPRESSION
Atur hanya jika driver miniport mendukung skema kompresi RAS yang lebih lama.

PPP_FRAMING
Harus selalu diatur. Menunjukkan driver miniport dapat mendeteksi dan mendukung pembingkaian PPP untuk jenis sedangnya.

PPP_COMPRESS_ADDRESS_CONTROL
Atur jika driver miniport mendukung alamat PPP dan kompresi bidang kontrol.

NDISWAN akan menghapus bidang alamat dan kontrol jika opsi LCP ini dinegosiasikan. Beberapa jenis sedang WAN, seperti X.25, tidak mendukung opsi ini.

PPP_COMPRESS_PROTOCOL_FIELD
Atur jika driver miniport mendukung pemadatan bidang protokol PPP.

NDISWAN akan menghapus satu byte dari bidang protokol jika berlaku jika opsi LCP ini dinegosiasikan.

PPP_ACCM_SUPPORTED
Atur jika driver miniport mendukung Pemetaan Karakter Kontrol Asinkron. Bit ini hanya berlaku untuk media asinkron, seperti modem. Jika bit ini diatur, anggota DesiredACCM harus valid.

PPP_MULTILINK_FRAMING
Atur jika driver miniport mendukung pembingkaian beberapa tautan seperti yang ditentukan dalam IETF RFC 1717.

PPP_SHORT_SEQUENCE_HDR_FORMAT
Atur jika driver miniport mendukung format header untuk pembingkaian beberapa tautan seperti yang ditentukan dalam IETF RFC 1717.

SLIP_FRAMING
Atur apakah driver miniport dapat mendeteksi dan mendukung pembingkaian SLIP (hanya driver miniport asinkron).

SLIP_VJ_COMPRESSION
Atur apakah driver miniport dapat mendukung kompresi header TCP/IP Van Jacobsen untuk SLIP. NDISWAN mendukung SLIP_VJ_COMPRESSION (dengan 16 slot). Media asinkron (driver miniport serial) yang mendukung pembingkaian SLIP harus mengatur bit ini.

Media asinkron tidak perlu menulis kode apa pun untuk mendukung kompresi header VJ. NDISWAN akan mengurusnya.

SLIP_VJ_AUTODETECT
Atur apakah driver miniport dapat mendeteksi kompresi header TCP/IP Van Jacobsen secara otomatis untuk SLIP. NDISWAN akan mendeteksi kompresi header VJ secara otomatis. Media asinkron (driver miniport serial) harus mengatur bit ini jika mendukung pembingkaian SLIP.

TAPI_PROVIDER
Atur jika driver miniport mendukung OID Penyedia Layanan TAPI. Kecuali bit ini diatur, panggilan TAPI OID tidak akan dilakukan ke driver miniport.

MEDIA_NRZ_ENCODING
Atur jika driver miniport mendukung pengodean NRZ, default PPP untuk beberapa jenis media seperti ISDN. Nilai ini dicadangkan untuk digunakan di masa mendatang.

MEDIA_NRZI_ENCODING
Atur jika driver miniport mendukung pengodean NRZI. Nilai ini dicadangkan untuk digunakan di masa mendatang.

MEDIA_NLPID
Atur apakah driver miniport memiliki dan dapat mengatur NLPID dalam bingkainya. Nilai ini dicadangkan untuk digunakan di masa mendatang.

RFC_1356_FRAMING
Atur jika driver miniport mendukung pembingkaian IETF RFC 1356 X.25 dan ISDN. Nilai ini dicadangkan untuk digunakan di masa mendatang.

RFC_1483_FRAMING
Atur jika driver miniport mendukung enkaplasi lapisan-5 adaptasi IETF RFC 1483 ATM. Nilai ini dicadangkan untuk digunakan di masa mendatang.

RFC_1490_FRAMING
Atur jika driver miniport mendukung pembingkaian IETF RFC 1490 Frame Relay. Nilai ini dicadangkan untuk digunakan di masa mendatang.

NBF_PRESERVE_MAC_ADDRESS
Atur jika driver miniport mendukung pembingkaian IETF seperti yang ditentukan dalam draf "Protokol Kontrol Bingkai PPP NETBIOS (NBFCP)."

SHIVA_FRAMING
Digantikan oleh NBF_PRESERVE_MAC_ADDRESS.

PASS_THROUGH_MODE
Atur apakah driver miniport melakukan pembingkaiannya sendiri. Jika bendera ini diatur, NDISWAN meneruskan bingkai, tidak diinterpretasikan, dan tidak dimodifikasi.

Driver miniport harus dalam mode pembingkaian PPP default hingga setiap driver miniport menerima permintaan OID_WAN_CO_SET_LINK_INFO . Driver miniport harus mendeteksi secara otomatis pembingkaian apa pun yang diklaimnya untuk didukung.

Misalnya, driver miniport yang mendukung pembingkaian RAS lama harus mendeteksi framing RAS secara otomatis dari pembingkaian PPP. Jika driver miniport mendeteksi skema pembingkaian selain default, driver miniport tersebut harus secara otomatis mengalihkan pembingkaiannya ke dalam pembingkaian yang baru terdeteksi.

Kueri berikutnya dengan OID_WAN_CO_GET_LINK_INFO harus menunjukkan pembingkaian yang terdeteksi. Jika belum ada pembingkaian yang terdeteksi, FramingBits harus nol dalam informasi NDIS_WAN_CO_GET_LINK_INFO yang dikembalikan.

Jika driver miniport WAN dipanggil kemudian dengan OID_WAN_CO_SET_LINK_INFO di mana anggota FramingBits nol, driver miniport harus mencoba mendeteksi pembingkaian secara otomatis pada penerimaan setiap bingkai.

DesiredACCM
Peta Karakter Kontrol Asinkron dinegosiasikan. Anggota ini hanya relevan untuk jenis media asinkron.

Persyaratan

Versi

Didukung untuk driver NDIS 6.0 dan NDIS 5.1 di Windows Vista. Didukung untuk driver NDIS 5.1 di Windows XP.

Header

Ntddndis.h (termasuk Ndis.h)

Lihat juga

NdisMCoIndicateStatus

OID_WAN_CO_GET_LINK_INFO

OID_WAN_CO_SET_LINK_INFO

WAN_CO_LINKPARAMS