Función WdfPdoRetrieveIdentificationDescription (wdfpdo.h)

Artículo
02/27/2024

[Solo se aplica a KMDF]

El método WdfPdoRetrieveIdentificationDescription recupera la descripción de identificación asociada a un objeto de dispositivo de marco especificado.

Sintaxis

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

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco que representa el objeto de dispositivo físico (PDO) del dispositivo.

[in, out] IdentificationDescription

Puntero a un búfer asignado por el autor de la llamada que recibirá la descripción de identificación. La descripción de identificación debe contener una estructura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER .

Valor devuelto

Si la operación se realiza correctamente, la función devuelve STATUS_SUCCESS. Entre los valores devueltos adicionales se incluyen:

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	El identificador de dispositivo no representa un PDO.
STATUS_INVALID_DEVICE_REQUEST	El identificador de dispositivo no representa un dispositivo enumerado dinámicamente o si la estructura de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER no contiene el tamaño de búfer correcto.

El método también podría devolver otros valores NTSTATUS.

Se produce una comprobación de errores del sistema si el controlador proporciona un identificador de objeto no válido.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Encabezado	wdfpdo.h (incluya Wdf.h)
Library	Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfPdoRetrieveAddressDescription