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 |