Función WdfDeviceRetrieveDeviceDirectoryString (wdfdevice.h)

[Solo se aplica a UMDF]

WdfDeviceRetrieveDeviceDirectoryString proporciona una ruta de acceso a una ubicación en el disco que se puede usar para conservar información entre reinicios.

Sintaxis

NTSTATUS WdfDeviceRetrieveDeviceDirectoryString(
  [_In_] WDFDEVICE Device,
  [_In_] WDFSTRING String
);

Parámetros

[_In_] Device

Identificador de un objeto de dispositivo de marco.

[_In_] String

Identificador de un objeto de cadena de marco. El marco asignará la ruta de acceso del directorio al objeto de cadena cuando se devuelva correctamente.

Valor devuelto

Esta función devuelve NTSTATUS. WdfDeviceRetrieveDeviceDirectoryString devuelve STATUS_SUCCESS si la operación se realiza correctamente.

Comentarios

UmDF solo. Los controladores KMDF deben usar IoGetDeviceDirectory.

Requisitos

Requisito Value
Versión mínima de UMDF 2.25
Encabezado wdfdevice.h
IRQL PASSIVE_LEVEL

Consulte también

Para obtener información sobre los objetos de cadena, vea Usar objetos de cadena.