Funzione WdfPdoRetrieveIdentificationDescription (wdfpdo.h)

  • Articolo

[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