PGET_LOCATION_STRING Rückruffunktion (ntddk.h)
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 |