Funzione WdfPdoInitAssignContainerID (wdfpdo.h)

Articolo
02/29/2024

[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 contenente una stringa ID contenitore. Il driver può allocare il buffer della stringa dal pool con pagine.

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 inizializza un oggetto FDO anziché un oggetto PDO.
STATUS_INSUFFICIENT_RESOURCES	Impossibile allocare spazio al driver per archiviare la stringa ID contenitore.

Il metodo potrebbe restituire anche altri valori NTSTATUS.

Commenti

Per altre informazioni sugli ID contenitore, vedere Stringhe di identificazione del dispositivo.

Il driver deve chiamare WdfPdoInitAssignContainerID prima di chiamare WdfDeviceCreate. Per altre informazioni sulla chiamata a WdfDeviceCreate, vedere Creazione di un oggetto dispositivo Framework.

Esempio

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 KMDF minima	1,9
Intestazione	wdfpdo.h (includere Wdf.h)
Libreria	Wdf01000.sys (vedere Framework Library Versioning).
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	DriverCreate(kmdf)