Función WdfDriverRetrieveDriverDataDirectoryString (wdfdriver.h)

[Solo se aplica a UMDF]

El método WdfDriverRetrieveDriverDataDirectoryString devuelve una ruta de acceso a un directorio del disco en el que el controlador puede almacenar información. Los archivos de ese directorio se aplican a un objeto de controlador de marco específico.

Sintaxis

NTSTATUS WdfDriverRetrieveDriverDataDirectoryString(
  [_In_] WDFDRIVER Driver,
  [_In_] WDFSTRING String
);

Parámetros

[_In_] Driver

Identificador del objeto de controlador del marco de trabajo del controlador que obtuvo el controlador de una llamada anterior a WdfDriverCreate o WdfDeviceGetDriver.

[_In_] String

Identificador de un objeto de cadena de marco que el controlador obtuvo de una llamada anterior a WdfStringCreate. El marco asigna la ruta de acceso completa del directorio del controlador solicitado al objeto de cadena.

Valor devuelto

WdfDriverRetrieveDriverDataDirectoryString devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método devuelve un código de error NTSTATUS adecuado. Para obtener más información, vea Valores NTSTATUS.

Comentarios

Para lograr el mismo resultado, un controlador KMDF debe llamar a IoGetDriverDirectory en su lugar.

Para obtener más información sobre los objetos de cadena, vea Using String Objects.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a WdfDriverRetrieveDriverDataDirectoryString:

NTSTATUS status;
WDFSTRING string;

status = WdfStringCreate(
                         NULL,
                         WDF_NO_OBJECT_ATTRIBUTES,
                         &string
                         );
if (NT_SUCCESS(status)) {
    status = WdfDriverRetrieveDriverDataDirectoryString(
                         Driver,
                         string
                         );
    if (!NT_SUCCESS(status)) {
        return status;
    }
}

Requisitos

Requisito	Value
Versión mínima de UMDF	2,27
Encabezado	wdfdriver.h
IRQL	PASSIVE_LEVEL

Consulte también

IoGetDriverDirectory

_DRIVER_DIRECTORY_TYPE (enumeración)