NdisMGetDeviceProperty (Compact 7)

3/12/2014

This function retrieves device objects required to set up communication with a miniport driver through a bus driver.

Syntax

VOID   NdisMGetDeviceProperty(
    NDIS_HANDLE  MiniportAdapterHandle,
    PDEVICE_OBJECT* PhysicalDeviceObject  OPTIONAL,
    PDEVICE_OBJECT* FunctionalDeviceObject  OPTIONAL,
    PDEVICE_OBJECT* NextDeviceObject  OPTIONAL,
    PCM_RESOURCE_LIST* AllocatedResources  OPTIONAL,
    PCM_RESOURCE_LIST* AllocatedResourcesTranslated  OPTIONAL
);

Parameters

• MiniportAdapterHandle
  [in] The NDIS handle that identifies the miniport adapter. This handle was originally passed to the MiniportInitializeEx function.

• PhysicalDeviceObject
  [in, out] A pointer to a caller-allocated buffer. The buffer receives a pointer to a DEVICE_OBJECT structure that represents the physical device for the miniport adapter. This pointer is optional.

• FunctionalDeviceObject
  [in, out] A pointer to a caller-allocated buffer. The buffer receives a pointer to a DEVICE_OBJECT structure. DEVICE_OBJECT represents the functional device object that NDIS creates for the physical device. This pointer is optional.

• NextDeviceObject
  [in, out] A pointer to a caller-allocated buffer. The buffer receives a pointer to a DEVICE_OBJECT structure that represents the next device object. This next device object is preceded in the chain by the functional device object that belongs to the miniport driver. NDIS creates this functional device object for the physical device. For example, the next device object could be the object that is associated with a bus driver or HAL This pointer is optional.

• AllocatedResources
  [in, out] A pointer to a caller-allocated buffer that receives a pointer to a CM_RESOURCE_LIST structure. CM_RESOURCE_LIST describes a list of hardware resources that the PnP manager assigns to the physical device. This list contains the resources in raw form, that is, not translated by HAL. This pointer is optional.

• AllocatedResourcesTranslated
  [in, out] A pointer to a caller-allocated buffer that receives a pointer to a CM_RESOURCE_LIST structure. CM_RESOURCE_LIST describes a list of hardware resources that the PnP manager assigns to the physical device. This list contains the resources in translated form, that is, translated by HAL. This pointer is optional.

Return Value

None.

Remarks

Miniport drivers must retrieve specific information to set up their communications. Miniport drivers for miniport instances that communicate through bus drivers use NdisMGetDeviceProperty to retrieve this information. For example, miniport driver instances that attach to Universal Serial Bus (USB) or IEEE 1394 buses require miniport drivers that expose a standard NDIS miniport driver interface at their upper edge, and use the class interface for the particular bus at their lower edge. To use the USB or 1394 class interface, a miniport driver creates and submits I/O Request Packets (IRPs). The miniport driver uses the physical and next-device objects that NdisMGetDeviceProperty retrieves to submit IRPs to the class interface for a particular bus.

Pointers to DEVICE_OBJECT for the physical, functional, and next device objects that NdisMGetDeviceProperty retrieves are handles that are opaque to the miniport driver.

Miniport drivers can call NdisMGetDeviceProperty to retrieve pointers to "raw" or "translated" resources. Raw resources have not been translated by HAL; translated resources have been. To locate more information about raw and translated resources, see UPnP.

Requirements

See Also

Reference

NDIS Functions for Miniport Drivers
MiniportInitializeEx