共用方式為


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 所指向的記憶體。

要求

要求 價值
最低支援的用戶端 從 Windows Server 2003 開始提供。
目標平臺 桌面
標頭 ntddk.h (include Ntddk.h, Ntifs.h)
IRQL <= PASSIVE_LEVEL

另請參閱

ExAllocatePoolWithTag

ExFreePool

PNP_LOCATION_INTERFACE