IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR IOCTL (sidebandaudio.h)
音訊驅動程式會發出 IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR,以取得已啟用側帶音訊設備介面的相關信息。 具體來說,這會傳回支援 Sideband 的裝置上可用的音訊端點數目。 此資訊會在音訊裝置描述元 結構 傳回。
主要程序代碼
輸入緩衝區
零。
輸入緩衝區長度
輸出緩衝區
包含 SIDEBANDAUDIO_DEVICE_DESCRIPTOR 結構的緩衝區。
輸出緩衝區長度
SIDEBANDAUDIO_DEVICE_DESCRIPTOR 結構的大小。
狀態區塊
如果例程成功,則 Status 會設定為 STATUS_SUCCESS,而 Information 成員是例程寫入輸出緩衝區的位元元組數目。
如果 Status 設定為STATUS_BUFFER_TOO_SMALL,則音訊驅動程式應該讀取 資訊 成員,以取得呼叫端應配置給此要求的緩衝區大小。
言論
此 IOCTL 只能從核心模式呼叫。
音訊驅動程式會傳送此要求,以取得已啟用音訊側帶裝置介面的相關信息。 在啟用介面時,資訊不會變更,但可以在停用介面時變更。 音訊驅動程式會在探索已啟用的側帶音訊設備介面后不久傳送此要求,並使用資訊來判斷有多少側帶音訊端點可供使用。
音訊驅動程式會以零 (0) 的輸出緩衝區大小傳送此要求一次,以判斷所需的輸出緩衝區大小。 在此情況下,要求會完成狀態STATUS_BUFFER_TOO_SMALL,並將 資訊 成員設定為所需的緩衝區大小。 接著,音訊驅動程式會配置必要的儲存空間,並再次傳送要求。 音訊驅動程式通常會在其裝置內容中儲存此儲存位置的指標,以供稍後活動期間參考。
接著,音訊驅動程式可以使用IOCTL IOCTL_SBAUD_GET_ENDPOINT_DESCRIPTOR反覆判斷每個端點功能。
要求
要求 | 價值 |
---|---|
標頭 | sidebandaudio.h |