Mengisi Struktur NDIS_GUID

Struktur NDIS_GUID didefinisikan sebagai berikut:

typedef struct _NDIS_GUID {
  GUID  Guid;
  union {
    NDIS_OID  Oid;
    NDIS_STATUS  Status;
  };
  ULONG  Size;
  ULONG  Flags;
} NDIS_GUID, *PNDIS_GUID;

Untuk mendapatkan GUID untuk anggota Guid struktur, Anda dapat menjalankan aplikasi Uuidgen.exe. Untuk informasi selengkapnya tentang aplikasi ini, lihat Menghasilkan UUID Antarmuka.

Anggota Oid atau Status adalah ULONG yang merupakan kode OID. NDIS 6.0 tidak memetakan indikasi status kustom ke GUID WMI.

Jika struktur NDIS_GUID memetakan OID yang mengembalikan array item data, anggota Ukuran menentukan ukuran, dalam byte, dari setiap item data dalam array. Jika data bukan array, anggota Ukuran menentukan ukuran data. Jika ukuran item data bervariasi, atau jika OID tidak mengembalikan data, anggota Ukuran harus -1.

Bitwise ATAU dari nilai berikut untuk anggota Bendera menunjukkan jenis data yang terkait dengan GUID:

fNDIS_GUID_TO_OID
Ketika bendera ini diatur, struktur NDIS_GUID memetakan GUID ke OID.

fNDIS_GUID_TO_STATUS
Dicadangkan untuk NDIS. Driver Miniport tidak boleh menggunakan bendera ini.

fNDIS_GUID_ANSI_STRING
Ketika bendera ini diatur, string ANSI yang dihentikan null disediakan untuk GUID.

fNDIS_GUID_UNICODE_STRING
Ketika bendera ini diatur, string Unicode disediakan untuk GUID.

fNDIS_GUID_ARRAY
Ketika bendera ini diatur, array item data disediakan untuk GUID. Nilai Ukuran yang ditentukan menunjukkan panjang setiap item data dalam array.

fNDIS_GUID_ALLOW_READ
Ketika bendera ini diatur, semua pengguna diizinkan untuk menggunakan GUID ini untuk mendapatkan informasi.

fNDIS_GUID_ALLOW_WRITE
Ketika bendera ini diatur, semua pengguna diizinkan untuk menggunakan GUID ini untuk mengatur informasi.

Catatan Secara default, GUID WMI kustom yang disediakan driver miniport hanya dapat diakses oleh pengguna dengan hak istimewa administrator. Pengguna dengan hak istimewa administrator selalu dapat membaca atau menulis ke GUID kustom jika driver miniport mendukung operasi baca atau tulis untuk GUID tersebut. Anda dapat mengatur bendera fNDIS_GUID_ALLOW_READ dan fNDIS_GUID_ALLOW_WRITE untuk memungkinkan semua pengguna mengakses GUID kustom.

Perhatikan bahwa untuk semua GUID kustom yang didaftarkan driver, driver harus mengatur fNDIS_GUID_TO_OID. Driver Miniport tidak boleh mengatur fNDIS_GUID_TO_STATUS. Semua bendera lainnya dapat digabungkan dengan menggunakan operasi OR bitwise.