IoQueryFullDriverPath 函式 （ntddk.h）
IoQueryFullDriverPath 例程會擷取為指定驅動程式物件載入之二進位檔的完整路徑名稱。 從 Windows 10 版本 1709 開始，呼叫端可能會查詢不是自己的驅動程序物件，只要它們使用適當的同步處理來確保DRIVER_OBJECT結構在呼叫期間仍然有效。
語法
NTSTATUS IoQueryFullDriverPath(
[in] PDRIVER_OBJECT DriverObject,
[out] PUNICODE_STRING FullPath
);
參數
[in] DriverObject
DRIVER_OBJECT 結構的指標。 如果您在執行版本 1709 之前的 Windows 10 版本電腦上呼叫 IoQueryFullDriverPath，此結構必須是呼叫驅動程式的驅動程序物件。
[out] FullPath
呼叫端配置之 UNICODE_STRING 結構的指標。 成功傳回時，此結構會包含路徑名稱。
傳回值
如果呼叫成功擷取路徑名稱，IoQueryFullDriverPath 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。
| 傳回碼 | 描述 |
|---|---|
| STATUS_ACCESS_DENIED | 目標驅動程式物件不屬於呼叫端。 此狀態代碼只會在 1709 之前的 Windows 10 版本傳回。 |
| STATUS_NOT_FOUND | 驅動程式對象沒有與其相關聯的區段（已載入的記憶體映射）。 |
| STATUS_INSUFFICIENT_RESOURCES | 資源不足，無法執行要求的作業。 |
言論
驅動程式可以呼叫此例程來查詢其二進位檔的完整路徑名稱，或從 Windows 10 版本 1709 開始，另一個驅動程式之二進位檔的完整路徑名稱。
呼叫端會配置 FullPath 參數所指向的 UNICODE_STRING 結構，但不需要初始化這個結構。 IoQueryFullDriverPath 假設此結構的原始內容無效，並加以覆寫。 此例程會從分頁系統記憶體配置字串緩衝區、將 結構的 Buffer 成員設定為指向此緩衝區，並設定 MaximumLength 和 Buffer 成員來描述緩衝區及其內容。
呼叫端負責釋放 FullPath所指向的記憶體 - 不再需要完整路徑字串時，>Buffer。 一般而言，呼叫者會呼叫例程來釋放此記憶體，例如 ExFreePool。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8.1 開始提供。 |
| 目標平臺 | 普遍 |
| 標頭 | ntddk.h （包括 Wdm.h、Ntddk.h、Ntifs.h） |
| 連結庫 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |