WdfPdoInitAssignContainerID-Funktion (wdfpdo.h)

Artikel
02/27/2024

[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
);

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 einem 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 eine FDO anstelle einer PDO.
STATUS_INSUFFICIENT_RESOURCES	Der Treiber konnte keinen Speicherplatz zum Speichern der Container-ID-Zeichenfolge zuweisen.

Die -Methode gibt möglicherweise auch andere NTSTATUS-Werte zurück.

Hinweise

Weitere Informationen zu Container-IDs finden Sie unter Geräteidentifikationszeichenfolgen.

Der Treiber muss WdfPdoInitAssignContainerID aufrufen, bevor WdfDeviceCreate aufgerufen wird. Weitere Informationen zum Aufrufen von WdfDeviceCreate finden Sie unter Erstellen eines Framework-Geräteobjekts.

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
KMDF-Mindestversion	1.9
Kopfzeile	wdfpdo.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).)
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf)