Funzione WdfDriverRetrieveDriverDataDirectoryString (wdfdriver.h)

[Si applica solo a UMDF]

Il metodo WdfDriverRetrieveDriverDataDirectoryString restituisce un percorso a una directory su disco in cui il driver può archiviare le informazioni. I file in tale directory si applicano a un oggetto driver del framework specifico.

Sintassi

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

Parametri

[_In_] Driver

Handle per l'oggetto driver del framework del driver ottenuto dal driver da una chiamata precedente a WdfDriverCreate o WdfDeviceGetDriver.

[_In_] String

Handle per un oggetto stringa del framework ottenuto dal driver da una chiamata precedente a WdfStringCreate. Il framework assegna il percorso completo della directory del driver richiesta all'oggetto stringa.

Valore restituito

WdfDriverRetrieveDriverDataDirectoryString restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo restituisce un codice di errore NTSTATUS appropriato. Per altre informazioni, vedere Valori NTSTATUS.

Commenti

Per ottenere lo stesso risultato, un driver KMDF deve chiamare invece IoGetDriverDirectory .

Per altre informazioni sugli oggetti stringa, vedere Uso di oggetti String.

Esempio

L'esempio di codice seguente illustra come chiamare 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;
    }
}

Requisiti

Requisito	Valore
Versione UMDF minima	2.27
Intestazione	wdfdriver.h
IRQL	PASSIVE_LEVEL

Vedi anche

IoGetDriverDirectory

enumerazione _DRIVER_DIRECTORY_TYPE