Edit

PNP_LOCATION_INTERFACE structure (ntddk.h)

  • Article

The PNP_LOCATION_INTERFACE structure describes the GUID_PNP_LOCATION_INTERFACE interface.

Syntax

typedef struct _PNP_LOCATION_INTERFACE {
  USHORT                 Size;
  USHORT                 Version;
  PVOID                  Context;
  PINTERFACE_REFERENCE   InterfaceReference;
  PINTERFACE_DEREFERENCE InterfaceDereference;
  PGET_LOCATION_STRING   GetLocationString;
} PNP_LOCATION_INTERFACE, *PPNP_LOCATION_INTERFACE;

Members

Size

The size, in bytes, of this structure.

Version

The driver-defined version of the interface.

Context

A pointer to interface-specific context information.

InterfaceReference

A pointer to an InterfaceReference routine that increments the reference count for the interface. The PINTERFACE_REFERENCE function pointer type is defined in the Wdm.h header file.

InterfaceDereference

A pointer to an InterfaceDereference routine that decrements the reference count for the interface. The PINTERFACE_DEREFERENCE function pointer type is defined in the Wdm.h header file.

GetLocationString

A pointer to the PnpGetLocationString routine for the interface. The routine supplies the device-specific part of the SPDRP_LOCATION_PATHS property for the device.

Remarks

A driver obtains a pointer to the PNP_LOCATION_INTERFACE structure by sending an IRP_MN_QUERY_INTERFACE IRP to its bus driver with InterfaceType set to GUID_PNP_LOCATION_INTERFACE.

Requirements

Requirement Value
Minimum supported client Windows Server 2003 and later versions of the Windows operating system.
Header ntddk.h (include Ntddk.h, Ntifs.h)

See also

IRP_MN_QUERY_INTERFACE

InterfaceDereference

InterfaceReference

PnpGetLocationString