PGET_DEVICE_INFORMATION回呼函式 (hdaudio.h)

發行項
02/29/2024

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。否則，例程會傳回適當的錯誤碼。下表顯示可能的傳回狀態代碼。

傳回碼	Description
STATUS_BUFFER_TOO_SMALL	表示 deviceInformation 緩衝區開頭所指定的大小太小。

備註

此例程會擷取靜態的裝置相依資訊，也就是資訊不會隨著時間動態變更。

deviceInformation 參數是緩衝區的指標，其中包含HDAUDIO_DEVICE_INFORMATION結構，例程會將 HD 音頻控制器的相關信息寫入其中。呼叫 GetDeviceInformation之前，呼叫端會配置緩衝區，並將緩衝區的大小以位元組為單位寫入緩衝區開頭的 Size 成員。