Funzione WdfPdoRetrieveIdentificationDescription (wdfpdo.h)

Articolo
02/27/2024

[Si applica solo a KMDF]

Il metodo WdfPdoRetrieveIdentificationDescription recupera la descrizione di 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 a un oggetto dispositivo framework che rappresenta l'oggetto dispositivo fisico del dispositivo (PDO).

[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 dispositivo non rappresenta un oggetto PDO.
STATUS_INVALID_DEVICE_REQUEST	L'handle dispositivo non rappresenta un dispositivo enumerato in modo dinamico oppure se la struttura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER non contiene le dimensioni corrette del buffer.

Il metodo potrebbe restituire anche altri valori NTSTATUS.

Un controllo del bug di sistema si verifica se il driver fornisce un handle di oggetti non valido.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Intestazione	wdfpdo.h (includere Wdf.h)
Libreria	Wdf01000.sys (vedere Framework Library Versioning).
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfPdoRetrieveAddressDescription

Condividi tramite