Bagikan melalui

Ekstensi NDIS (Ndiskd.dll)

  • Artikel

Bagian ini menjelaskan perintah yang tersedia di !ndiskd, ekstensi debugger yang berguna untuk men-debug driver NDIS (Spesifikasi Antarmuka Perangkat Jaringan). Perintah ini memungkinkan pengembang driver jaringan untuk melihat gambaran yang lebih besar dari tumpukan jaringan Windows dan bagaimana driver mereka berinteraksi dengannya. Dengan !ndiskd, Anda dapat melihat status semua adaptor jaringan (!ndiskd.netadapter), diagram visual tumpukan jaringan komputer (!ndiskd.netreport), log lalu lintas pada adaptor jaringan(!ndiskd.nbllog), atau daftar semua permintaan OID yang tertunda (!ndiskd.oid).

Perintah dapat ditemukan di Ndiskd.dll. Untuk memuat simbol, masukkan .reload /f ndis.sys di jendela perintah debugger. Untuk mengonfirmasi bahwa simbol berhasil dimuat, gunakan ekstensi !lmi ndis dan cari frasa "Simbol berhasil dimuat" ke arah bawah. Output Anda akan terlihat serupa dengan contoh berikut:

0: kd> !lmi ndis
Loaded Module Info: [ndis] 
         Module: ndis
   Base Address: fffff80174570000
     Image Name: ndis.sys
   Machine Type: 34404 (X64)
     Time Stamp: 938f9f4e (This is a reproducible build file hash, not a true timestamp)
           Size: 16f000
       CheckSum: 167a05
Characteristics: 22  
Debug Data Dirs: Type  Size     VA  Pointer
             CODEVIEW    21, d4060,   d2c60 RSDS - GUID: {9CC82DBE-96A0-773D-29E0-62B698C4C3A8}
               Age: 1, Pdb: ndis.pdb
                 POGO   988, d4084,   d2c84 [Data not mapped]
                REPRO    24, d4a0c,   d360c Reproducible build[Data not mapped]
     Image Type: MEMORY   - Image read successfully from loaded memory.
    Symbol Type: PDB      - Symbols loaded successfully from symbol server.
                 C:\ProgramData\Dbg\sym\ndis.pdb\9CC82DBE96A0773D29E062B698C4C3A81\ndis.pdb
    Load Report: public symbols , not source indexed 
                 C:\ProgramData\Dbg\sym\ndis.pdb\9CC82DBE96A0773D29E062B698C4C3A81\ndis.pdb

Banyak perintah ekstensi di !ndiskd memberi Anda hyperlink dalam hasil yang ditampilkan di jendela debugger. Teks untuk hyperlink ini telah dibiarkan dalam sampel yang disediakan untuk mengilustrasikan format yang tepat dari apa yang akan Anda lihat saat Menjalankan perintah pada komputer debugee Anda. Beberapa contoh juga merujuk secara eksplisit untuk mengklik tautan ini sehingga Anda dapat memahami alur penggunaan umum, meskipun contohnya juga menyediakan bentuk baris perintah alternatif dari setiap perintah.

Parameter Umum

Semua perintah !ndiskd mendukung parameter generik berikut.

-penyedehanaan kata
Memperlihatkan detail tambahan.

-Singkat
Menekan beberapa output boilerplate.

-Statis
Menekan beberapa output interaktif.

-dml 0|1
Mengontrol apakah output DML (bahasa markup debugger) diaktifkan.

-unicode 0|1
Mengontrol apakah output karakter Unicode diizinkan.

-inden N
Menggunakan spasi N per tingkat inden.

-paksa
Mengambil alih beberapa pemeriksaan keamanan pada kewarasan data jarak jauh.

-tracedata
Menampilkan pesan pelacakan verbose untuk men-debug !ndiskd itu sendiri.

Adaptor Bersih, Driver NDIS, dan Perintah Umum

Perintah berikut menampilkan informasi tentang adaptor jaringan komputer, driver jaringan, dan perintah umum yang terkait dengan tumpukan jaringan (seperti rcvqueues, opens, filter, OID, dan kunci RW).

Perintah NET_BUFFER_LIST dan NET_BUFFER

Perintah berikut menampilkan informasi yang berkaitan dengan struktur NET_BUFFER_LIST dan NET_BUFFER.

Perintah NetAdapterCx

Perintah berikut menampilkan informasi yang berkaitan dengan Network Adapter WDF Class Extension NetAdapterCx dan struktur terkait, NET_RING_BUFFER dan NET_PACKET.

Perintah Antarmuka Jaringan

Perintah berikut menampilkan informasi yang berkaitan dengan antarmuka jaringan.

Perintah NDIS_PACKET

Perintah berikut menampilkan informasi tentang struktur NDIS_PACKET . Ekstensi ini untuk driver NDIS 5.x warisan. Struktur NDIS_PACKET dan arsitektur terkait telah tidak digunakan lagi.

Perintah CoNDIS

Perintah berikut menampilkan informasi tentang koneksi NDIS Berorientasi Koneksi.

Perintah Debugging NDIS

Perintah berikut menampilkan informasi yang berkaitan dengan refcount NDIS, log peristiwa, jejak tumpukan, dan jejak debug.

Perintah WDI

Perintah berikut menampilkan informasi tentang Driver WDI Miniport.

Perintah Informasi NDIS dan !ndiskd

Perintah berikut menampilkan informasi tentang NDIS.sys dan ndiskd.dll.

Perintah Lain-lain

Untuk informasi selengkapnya tentang merancang driver NDIS untuk Windows Vista dan yang lebih baru, lihat Panduan Desain Driver Jaringan.

Untuk informasi selengkapnya tentang referensi untuk driver NDIS untuk Windows Vista dan yang lebih baru, lihat Referensi Jaringan Windows Vista dan Yang Lebih Baru.

Untuk demonstrasi menggunakan perintah debugger !ndiskd untuk men-debug tumpukan jaringan, lihat video Debugging saluran Tumpukan Jaringan 9.