OID_GEN_SUPPORTED_GUIDS

Sebagai kueri, OID_GEN_SUPPORTED_GUIDS OID meminta driver miniport untuk mengembalikan array struktur jenis NDIS_GUID.

Informasi Versi

Windows Vista dan versi Windows yang lebih baru
Didukung.

Driver miniport NDIS 6.0 dan yang lebih baru
Pilihan.

Driver miniport NDIS 5.1
Pilihan.

Windows XP
Didukung.

Driver miniport NDIS 5.1
Pilihan.

Keterangan

Setiap struktur dalam array menentukan pemetaan GUID kustom (pengidentifikasi unik global) ke OID kustom atau ke NDIS_STATUS yang dikirim driver miniport melalui fungsi NdisMIndicateStatusEx .

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;

Anggota struktur ini berisi informasi berikut:

Guid
Menentukan GUID kustom yang ditentukan untuk driver miniport.

Oid
Menentukan OID kustom yang dipetakan Guid .

Kondisi
Menentukan NDIS_STATUS yang dipetakan Guid .

Ukuran
Menentukan ukuran dalam byte setiap item data dalam array yang dikembalikan oleh driver miniport. Jika bendera fNDIS_GUID_ANSI_STRING atau fNDIS_GUID_NDIS_STRING diatur, Ukuran diatur ke -1. Jika tidak, Ukuran menentukan ukuran dalam byte item data yang diwakili GUID. Anggota ini hanya ditentukan ketika bendera fNDIS_GUID_ARRAY diatur.

Bendera
Bendera berikut dapat digabungkan oleh operator OR untuk menunjukkan apakah GUID memetakan ke OID atau ke string NDIS_STATUS dan untuk menunjukkan jenis data yang disediakan untuk GUID:

fNDIS_GUID_TO_OID
Menunjukkan bahwa struktur NDIS_GUID memetakan GUID ke OID.

fNDIS_GUID_TO_STATUS
Menunjukkan bahwa struktur NDIS_GUID memetakan GUID ke string NDIS_STATUS.

fNDIS_GUID_ANSI_STRING
Menunjukkan bahwa string ANSI yang dihentikan null disediakan untuk GUID.

fNDIS_GUID_UNICODE_STRING
Menunjukkan bahwa string Unicode disediakan untuk GUID.

fNDIS_GUID_ARRAY
Menunjukkan bahwa array item data disediakan untuk GUID. Ukuran yang ditentukan menunjukkan panjang setiap item data dalam array.

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

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

Catatan Secara default, GUID WMI kustom yang disediakan oleh 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. Atur bendera fNDIS_GUID_ALLOW_READ dan fNDIS_GUID_ALLOW_WRITE untuk memungkinkan semua pengguna mengakses GUID kustom.

Perhatikan bahwa semua GUID kustom yang didaftarkan oleh driver miniport harus mengatur fNDIS_GUID_TO_OID atau fNDIS_GUID_TO_STATUS (tidak pernah mengatur keduanya). Semua bendera lain dapat digabungkan dengan menggunakan operator OR sebagaimana berlaku.

Dalam contoh berikut, struktur NDIS_GUID memetakan GUID ke OID_802_3_MULTICAST_LIST:

NDIS_GUID    NdisGuid = {{0x44795701, 0xa61b, 0x11d0, 0x8d, 0xd4,
                          0x00, 0xc0, 0x4f, 0xc3,
                          0x35, 0x8c},
                          OID_802_3_MULTICAST_LIST,
                          6,
                          fNDIS_GUID_TO_OID | fNDIS_GUID_ARRAY};

GUID adalah pengidentifikasi yang digunakan oleh Windows Management Instrumentation (WMI) untuk mendapatkan atau mengatur informasi. NDIS mencegat GUID yang dikirim oleh WMI ke driver NDIS, memetakan GUID ke OID, dan mengirim OID ke driver. Driver mengembalikan item data ke NDIS, yang kemudian mengembalikan data ke WMI.

NDIS juga menerjemahkan perubahan status NIC menjadi GUID yang dikenali oleh WMI. Ketika driver miniport melaporkan perubahan status NIC menggunakan fungsi NdisMIndicateStatusEx , NDIS menerjemahkan NDIS_STATUS yang ditunjukkan oleh driver miniport ke dalam GUID yang dikirim NDIS ke WMI.

Jika driver miniport mendukung GUID kustom, driver harus mendukung OID_GEN_SUPPORTED_GUIDS. OID ini kembali ke NDIS pemetaan GUID kustom ke OID kustom atau string NDIS_STATUS. Setelah mengkueri driver miniport menggunakan OID_GEN_SUPPORTED_GUIDS, NDIS mendaftarkan GUID kustom driver miniport dengan WMI.

Persyaratan

Header

Ntddndis.h (termasuk Ndis.h)

Lihat juga

NdisMIndicateStatusEx