Customized OIDs and Status Indications

You can create a custom OID that NDIS maps to a custom GUID that you create. NDIS registers the custom GUID with WMI for the miniport driver so that WMI clients can query or set the associated information.

To provide a custom status indication, NDIS miniport drivers must use the NDIS_STATUS_MEDIA_SPECIFIC_INDICATION_EX status indication. The WMI clients must use the data that is included with the WMI event to identify the custom event. NDIS does not register custom GUIDs for status indications.

To obtain a miniport adapter's custom OIDs and the associated WMI GUIDs, NDIS issues OID requests to the miniport driver after the miniport driver has completed initialization. NDIS issues an OID_GEN_SUPPORTED_LIST query to obtain the list of the OIDs that the miniport driver supports. The miniport driver includes both custom OIDs and standard OIDs in its response. To obtain the GUIDs that are associated with the custom OIDs, NDIS issues an OID_GEN_SUPPORTED_GUIDS query to connectionless miniport drivers or an OID_GEN_CO_SUPPORTED_GUIDS query to connection-oriented miniport drivers.

The query to OID_GEN_SUPPORTED_GUIDS or OID_GEN_CO_SUPPORTED_GUIDS returns an array of NDIS_GUID structures to NDIS. Each NDIS_GUID structure maps a custom GUID to a custom OID.

To support custom OIDs and status indications, you must fill in NDIS_GUID structures. You must also create a managed object format (MOF) file that describes the GUID and build this file with the miniport driver.

This section includes:

Filling in an NDIS_GUID Structure

Including a MOF File