IRP_MN_QUERY_DEVICE_TEXT

發行項
06/15/2023

PnP 管理員會使用此 IRP 來取得裝置的描述或位置資訊。

如果匯流排支援這項資訊，則匯流排驅動程式必須處理其子裝置的此要求。函式和篩選驅動程式不會處理此 IRP。

值

0x0C

主要程式碼

IRP_MJ_PNP

傳送時

當列舉裝置時，PnP 管理員會傳送這兩個 IRP：一個用來查詢裝置描述，另一個用來查詢位置資訊。

PnP 管理員會在任意執行緒內容中，在 IRQL PASSIVE_LEVEL傳送此 IRP。

輸入參數

IO_STACK_LOCATION結構的Parameters.QueryDeviceText.DeviceTextType成員是指定要求字串的DEVICE_TEXT_TYPE值。 DEVICE_TEXT_TYPE可能的值為DeviceTextDescription和DeviceTextLocationInformation。

Parameters.QueryDeviceText.LocaleId 是 LCID，指定所要求文字的地區設定。

輸出參數

在 I/O 狀態欄塊中傳回。

I/O 狀態欄塊

驅動程式會將 Irp-IoStatus.Status > 設定為STATUS_SUCCESS或適當的錯誤狀態。

成功時，匯流排驅動程式會將 Irp-IoStatus.Information > 設定為驅動程式配置的記憶體區塊指標，其中包含具有要求資訊的 WCHAR 緩衝區。發生錯誤時，匯流排驅動程式會將 Irp-IoStatus.Information > 設定為零。

作業

強烈建議匯流排驅動程式傳回其子裝置的裝置描述。如果找不到裝置的 INF 相符專案，此字串會顯示在 [ 找到新的硬體 ] 快顯視窗中。

也鼓勵匯流排驅動程式為其子裝置傳回 LocationInformation ，但這項資訊是選擇性的。此字串的格式取決於匯流排。裝置管理員會在裝置的 [一般屬性] 索引標籤中顯示此字串。廠商應該選擇一個字串，將有用的資訊傳達給使用者和支援人員。例如，針對 PCI，字串包含匯流排、裝置和函式。若為電腦卡片，字串會包含位置。

如果匯流排驅動程式傳回信息以回應此 IRP，它會從分頁記憶體配置 Null 終止的 Unicode 字串。當不再需要字串時，PnP 管理員會釋放字串。

如果裝置未提供描述或位置資訊，裝置的父匯流排驅動程式會完成 IRP (IoCompleteRequest) ，而不需修改Irp-IoStatus.Status 或 Irp-IoStatus.Information >>。

函式和篩選驅動程式不會處理此 IRP;它們會將它傳遞至下一個較低驅動程式，但不會變更 Irp-IoStatus >。

支援不同地區設定不同文字字串之匯流排的驅動程式應該能夠處理裝置未明確支援之語言的要求。在這種情況下，匯流排驅動程式應該傳回最接近的地區設定相符專案，或應該後援並傳回一些適當的地區設定字串。

如需處理隨插即用次要 IRP的一般規則，請參閱隨插即用。

傳送此 IRP

保留供系統使用。驅動程式不得傳送此 IRP。

規格需求

標頭	Wdm.h (包括 Wdm.h、Ntddk.h 或 Ntifs.h)

共用方式為