Funzione WdfPdoRetrieveIdentificationDescription (wdfpdo.h)

Articolo
03/22/2025

[Si applica solo a KMDF]

Il metodo WdfPdoRetrieveIdentificationDescription recupera la descrizione dell'identificazione associata a un oggetto dispositivo framework specificato.

Sintassi

NTSTATUS WdfPdoRetrieveIdentificationDescription(
  [in]      WDFDEVICE                                    Device,
  [in, out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework che rappresenta l'oggetto dispositivo fisico (PDO) del dispositivo.

[in, out] IdentificationDescription

Puntatore a un buffer allocato dal chiamante che riceverà la descrizione dell'identificazione. La descrizione dell'identificazione deve contenere una struttura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER.

Valore restituito

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

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	L'handle del dispositivo non rappresenta un PDO.
STATUS_INVALID_DEVICE_REQUEST	L'handle del dispositivo non rappresenta un dispositivo enumerato dinamicamenteo se la struttura di WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER non contiene le dimensioni corrette del buffer.

Il metodo potrebbe anche restituire altri valori NTSTATUS.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo dei bug di sistema.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
versione minima di KMDF	1.0
intestazione	wdfpdo.h (include Wdf.h)
Biblioteca	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	<= LIVELLO_DI_INVIO
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfPdoRetrieveAddressDescription

Condividi tramite