PGET_LOCATION_STRING Rückruffunktion (ntddk.h)

  • Artikel

Die PnpGetLocationString-Routine stellt den gerätespezifischen Teil der SPDRP_LOCATION_PATHS-Eigenschaft des Geräts bereit.

Syntax

PGET_LOCATION_STRING PgetLocationString;

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

Parameter

[in, out] Context

Ein Zeiger auf schnittstellenspezifische Kontextinformationen. Der Aufrufer übergibt den Wert, der als Context-Member der PNP_LOCATION_INTERFACE-Struktur übergeben wird.

[out] LocationStrings

Ein Zeiger auf eine Sequenz von Unicode-Zeichenfolgen, die mit null enden, die durch eine andere Null beendet wird. Jede Zeichenfolge dient als Standortzeichenfolge für das Gerät. Treiber geben in der Regel eine einzelne Zeichenfolge zurück.

Rückgabewert

Die Routine gibt einen NTSTATUS-Wert zurück, um die status des Vorgangs anzugeben.

Hinweise

Die PNP_LOCATION_INTERFACE-Struktur stellt einen Zeiger auf die PnpGetLocationString-Routine bereit.

Die PnpGetLocationString-Routine stellt den gerätespezifischen Teil der Standortzeichenfolge für das Gerät bereit. Der Plug & Play-Manager (PnP) stellt die Standortzeichenfolge für ein Gerät zusammen, indem er den Treiber für das Gerät, den Gerätebus und alle übergeordneten Busse abfragt und die bereitgestellten Zeichenfolgen verkettet.

Die Routine muss eine Zeichenfolge zurückgeben, die für das Gerät im Verhältnis zu seinem Bus eindeutig ist. Die Zeichenfolge muss für das Gerät in allen Versionen des Betriebssystems identisch sein. Nachdem Sie eine Zeichenfolge für diesen Zweck ausgewählt haben, dürfen Sie sie nicht mehr ändern.

Gemäß der Konvention nimmt die Location-Zeichenfolge das Format ServiceName(BusSpecificLocation) an. Beispielsweise verwenden PCI-Geräte PCI(XXYY), wobei XX die Gerätenummer und JJ die Funktionsnummer ist.

Die PnpGetLocationString-Routine ruft eine Routine wie ExAllocatePoolWithTag auf, um den Arbeitsspeicher für die Speicherortzeichenfolge zuzuweisen. Der Aufrufer ist für den Aufruf der ExFreePool-Routine verantwortlich, um den Speicher freizugeben, auf den LocationStrings verweist, wenn die Standortzeichenfolge nicht mehr benötigt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows Server 2003.
Zielplattform Desktop
Kopfzeile ntddk.h (include Ntddk.h, Ntifs.h)
IRQL <= PASSIVE_LEVEL

Weitere Informationen

ExAllocatePoolWithTag

ExFreePool

PNP_LOCATION_INTERFACE