共用方式為

WdfDriverRetrieveDriverDataDirectoryString 函式 (wdfdriver.h)

  • 發行項

[僅適用於 UMDF]

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

語法

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列舉