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。 可能的錯誤傳回值包括下列狀態代碼。
| 傳回碼 | Description |
|---|---|
| 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 開始提供。 |
| 目標平台 | Universal |
| 標頭 | ntddk.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |