WdfPdoInitAssignContainerID-Funktion (wdfpdo.h)

Artikel
03/22/2025

[Gilt nur für KMDF]

Die WdfPdoInitAssignContainerID Methode aktualisiert die Container-ID für ein untergeordnetes Gerät.

Syntax

NTSTATUS WdfPdoInitAssignContainerID(
  [in] PWDFDEVICE_INIT  DeviceInit,
  [in] PCUNICODE_STRING ContainerID
);

Die Parameter

[in] DeviceInit

Ein Zeiger auf eine WDFDEVICE_INIT Struktur.

[in] ContainerID

Ein Zeiger auf eine UNICODE_STRING Struktur, die eine Container-ID-Zeichenfolge enthält. Der Treiber kann den Puffer der Zeichenfolge aus dem ausgelagerten Pool zuordnen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode STATUS_SUCCESS zurück. Weitere Rückgabewerte sind:

Rückgabecode	BESCHREIBUNG
STATUS_INVALID_DEVICE_REQUEST	Der Treiber initialisiert einen FDO anstelle eines PDO.
STATUS_INSUFFICIENT_RESOURCES	Der Treiber konnte keinen Speicherplatz zuordnen, um die Container-ID-Zeichenfolge zu speichern.

Die Methode kann auch andere NTSTATUS-Wertezurückgeben.

Bemerkungen

Weitere Informationen zu Container-IDs finden Sie unter Device Identification Strings.

Der Treiber muss WdfPdoInitAssignContainerID- aufrufen, bevor WdfDeviceCreateaufgerufen wird. Weitere Informationen zum Aufrufen WdfDeviceCreatefinden Sie unter Creating a Framework Device Object.

Beispiele

Im folgenden Codebeispiel wird eine UNICODE_STRING-Struktur initialisiert, eine Unicode-Zeichenfolge in der Struktur gespeichert und anschließend die Unicode-Zeichenfolge als Container-ID des Geräts registriert.

UNICODE_STRING containerId = {0}; 

RtlInitUnicodeString(
                     &containerId,
                     strContainerId //Unicode string for container ID
                     );
status = WdfPdoInitAssignContainerID(
                                     pDeviceInit,
                                     &containerId
                                     );

Anforderungen

Anforderung	Wert
Zielplattform	universell
Minimale KMDF-Version	1.9
Kopfzeile	wdfpdo.h (include Wdf.h)
Bibliothek	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf)