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 mit Null beendeten Unicode-Zeichenfolgen, die durch eine andere Null beendet wird. Jede Zeichenfolge dient als Positionszeichenfolge 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 den Status des Vorgangs anzugeben.
Bemerkungen
Die PNP_LOCATION_INTERFACE struktur stellt einen Zeiger auf die PnpGetLocationString Routine bereit.
Die PnpGetLocationString- Routine stellt den gerätespezifischen Teil der Positionszeichenfolge für das Gerät bereit. Der Plug and Play -Manager (PnP) fasst die Positionszeichenfolge für ein Gerät zusammen, indem der Treiber für das Gerät, der Bus des Geräts und alle übergeordneten Busse und die bereitgestellten Zeichenfolgen miteinander verkettet werden.
Die Routine muss eine Zeichenfolge zurückgeben, die für das Gerät relativ zum Bus eindeutig ist. Die Zeichenfolge muss für das Gerät in allen Versionen des Betriebssystems identisch sein. Nachdem Sie eine Zeichenfolge zu diesem Zweck ausgewählt haben, dürfen Sie sie nicht mehr ändern.
In der Konvention übernimmt die Location-Zeichenfolge die Form ServiceName(BusSpecificLocation). Beispielsweise verwenden PCI-Geräte PCI(XXYY), wobei XX die Gerätenummer ist, und YYY- die Funktionsnummer ist.
Die PnpGetLocationString- Routine ruft eine Routine wie ExAllocatePoolWithTag auf, um den Speicher für die Speicherortzeichenfolge zuzuweisen. Der Aufrufer ist dafür verantwortlich, die ExFreePool Routine aufzurufen, um den Speicher freizugeben, auf den LocationStrings verweist, wenn die Standortzeichenfolge nicht mehr benötigt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Ab Windows Server 2003 verfügbar. |
| Zielplattform- | Desktop |
| Header- | ntddk.h (enthalten Ntddk.h, Ntifs.h) |
| IRQL- | <= PASSIVE_LEVEL |