Funzione WdfPdoInitAssignContainerID (wdfpdo.h)

Articolo
03/22/2025

[Si applica solo a KMDF]

Il metodo WdfPdoInitAssignContainerID aggiorna l'ID contenitore per un dispositivo figlio.

Sintassi

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

Parametri

[in] DeviceInit

Puntatore a una struttura WDFDEVICE_INIT.

[in] ContainerID

Puntatore a una struttura UNICODE_STRING che contiene una stringa ID contenitore. Il driver può allocare il buffer della stringa dal pool di paging.

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce STATUS_SUCCESS. I valori restituiti aggiuntivi includono:

Codice restituito	Descrizione
STATUS_INVALID_DEVICE_REQUEST	Il driver sta inizializzando un oggetto FDO anziché un PDO.
STATUS_INSUFFICIENT_RESOURCES	Impossibile allocare spazio al driver per archiviare la stringa ID contenitore.

Il metodo potrebbe anche restituire altri valori NTSTATUS .

Osservazioni:

Per altre informazioni sugli ID contenitore, vedere stringhe di identificazione dei dispositivi.

Il driver deve chiamare WdfPdoInitAssignContainerID prima di chiamare WdfDeviceCreate. Per altre informazioni sulla chiamata di WdfDeviceCreate, vedere Creating a Framework Device Object.

Esempi

L'esempio di codice seguente inizializza una struttura UNICODE_STRING, archivia una stringa Unicode nella struttura e quindi registra la stringa Unicode come ID contenitore del dispositivo.

UNICODE_STRING containerId = {0}; 

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
versione minima di KMDF	1.9
intestazione	wdfpdo.h (include Wdf.h)
Biblioteca	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	PASSIVE_LEVEL
regole di conformità DDI	DriverCreate(kmdf)