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 |