Fungsi WdfDriverRetrieveDriverDataDirectoryString (wdfdriver.h)

[Hanya berlaku untuk UMDF]

Metode WdfDriverRetrieveDriverDataDirectoryString mengembalikan jalur ke direktori pada disk tempat driver dapat menyimpan informasi. File dalam direktori tersebut berlaku untuk objek driver kerangka kerja tertentu.

Sintaks

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

Parameter

[_In_] Driver

Handel ke objek driver kerangka kerja driver yang diperoleh driver dari panggilan sebelumnya ke WdfDriverCreate atau WdfDeviceGetDriver.

[_In_] String

Handel ke objek string kerangka kerja yang diperoleh driver dari panggilan sebelumnya ke WdfStringCreate. Kerangka kerja menetapkan jalur yang sepenuhnya memenuhi syarat dari direktori driver yang diminta ke objek string.

Nilai kembali

WdfDriverRetrieveDriverDataDirectoryString mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode ini mengembalikan kode kesalahan NTSTATUS yang sesuai. Untuk informasi selengkapnya, lihat Nilai NTSTATUS.

Keterangan

Untuk mencapai hasil yang sama, driver KMDF harus memanggil IoGetDriverDirectory sebagai gantinya.

Untuk informasi selengkapnya tentang objek string, lihat Menggunakan Objek String.

Contoh

Contoh kode berikut menunjukkan cara memanggil 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;
    }
}

Persyaratan

Persyaratan	Nilai
Versi UMDF minimum	2.27
Header	wdfdriver.h
IRQL	PASSIVE_LEVEL

Lihat juga

IoGetDriverDirectory

Enumerasi _DRIVER_DIRECTORY_TYPE