PGET_LOCATION_STRING回呼函式 (ntddk.h)

PnpGetLocationString 例程會提供裝置SPDRP_LOCATION_PATHS屬性的裝置特定部分。

語法

PGET_LOCATION_STRING PgetLocationString;

NTSTATUS PgetLocationString(
  [in, out] PVOID Context,
  [out]     PZZWSTR *LocationStrings
)
{...}

[in, out] Context

介面特定內容資訊的指標。呼叫端會傳遞作為PNP_LOCATION_INTERFACE結構之Context成員傳遞的值。

[out] LocationStrings

以 Null 終止之 Unicode 字串序列的指標，由另一個零終止。每個字串都會作為裝置的位置字串。驅動程式通常會傳回單一字串。

例程會傳回NTSTATUS值，以指出作業的狀態。

PNP_LOCATION_INTERFACE 結構會提供 PnpGetLocationString 例程的指標。

PnpGetLocationString 例程會提供裝置位置字串的裝置特定部分。隨插即用 (PnP) 管理員會藉由查詢裝置的驅動程式、裝置總線和任何父總線，並將提供的字串串連在一起，來組合裝置的位置字串。

例程必須傳回相對於其總線之裝置唯一的字串。對於所有操作系統版本的裝置而言，字串必須相同。一旦您為此目的選取字串之後，就不得加以變更。

依照慣例，位置字串的格式為 ServiceName (BusSpecificLocation) 。例如，PCI 裝置使用PCI (XXYY) ，其中 XX 是裝置號碼， 而 YY 是函式編號。

PnpGetLocationString 例程會呼叫 ExAllocatePoolWithTag 之類的例程，以配置位置字串的記憶體。呼叫端負責呼叫 ExFreePool 例程，以在不再需要位置字串時釋放 LocationStrings 所指向的記憶體。