PGET_DEVICE_INFORMATION回呼函式 （hdaudio.h）
GetDeviceInformation 例程會擷取 HD 音訊控制器裝置的相關信息。
GetDeviceInformation 例程的函式指標類型定義如下。
語法
PGET_DEVICE_INFORMATION PgetDeviceInformation;
NTSTATUS PgetDeviceInformation(
[in] PVOID _context,
[in, out] PHDAUDIO_DEVICE_INFORMATION DeviceInformation
)
{...}
參數
[in] _context
指定 HDAUDIO_BUS_INTERFACE 或 HDAUDIO_BUS_INTERFACE_V2 結構之 Context 成員的內容值。
[in, out] DeviceInformation
擷取 HD 音訊控制器裝置的相關信息。 此參數指向呼叫端配置的 HDAUDIO_DEVICE_INFORMATION 結構，例程會將裝置資訊寫入其中。
傳回值
如果呼叫成功，GetDeviceInformation 會傳回STATUS_SUCCESS。 否則，例程會傳回適當的錯誤碼。 下表顯示可能的傳回狀態代碼。
| 傳回碼 | 描述 |
|---|---|
|
表示 deviceInformation 緩衝區開頭所指定的大小太小。 |
言論
此例程會擷取靜態的裝置相依資訊，也就是資訊不會隨著時間動態變更。
deviceInformation 參數是緩衝區的指標，其中包含HDAUDIO_DEVICE_INFORMATION結構，例程會將 HD 音訊控制器的相關信息寫入其中。 在呼叫 GetDeviceInformation之前，呼叫端會配置緩衝區，並將緩衝區的大小以位元組為單位寫入緩衝區的 Size 成員的緩衝區開頭。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 桌面 |
| 標頭 | hdaudio.h （包括 Hdaudio.h） |
| IRQL | PASSIVE_LEVEL |