共用方式為

WdfDriverRetrieveDriverDataDirectoryString 函式 （wdfdriver.h）

  • 發行項

[僅適用於 UMDF]

WdfDriverRetrieveDriverDataDirectoryString 方法會傳回磁碟上可儲存資訊之目錄的路徑。 該目錄中的檔案會套用至特定的架構驅動程序物件。

語法

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

參數

[_In_] Driver

驅動程式架構驅動程序物件的句柄，驅動程式從先前呼叫 WdfDriverCreate 或 WdfDeviceGetDriver取得。

[_In_] String

驅動程式從先前呼叫 WdfStringCreate取得的架構字串物件的句柄。 架構會將要求之驅動程式目錄的完整路徑指派給字串物件。

返回值

WdfDriverRetrieveDriverDataDirectoryString 如果作業成功，就會傳回STATUS_SUCCESS。 否則，這個方法會傳回適當的NTSTATUS錯誤碼。 如需詳細資訊，請參閱 NTSTATUS 值。

備註

為了達到相同的結果，KMDF 驅動程式應該改為呼叫 IoGetDriverDirectory。

如需字串物件的詳細資訊，請參閱使用字串物件 。

範例

下列程式代碼範例示範如何呼叫 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;
    }
}

需求

要求 價值
最低 UMDF 版本 2.27
標題 wdfdriver.h
IRQL PASSIVE_LEVEL

另請參閱

IoGetDriverDirectory

_DRIVER_DIRECTORY_TYPE 列舉