CODECAPI_ALLSETTINGS 屬性可用來來回傳遞迷你驅動程式產生的數據區塊。
| 獲取 | 設定 | 目標 | 屬性描述項類型 | 屬性值類型 |
|---|---|---|---|---|
| 是的 | 是的 | 篩選器 | KSPROPERTY | PVOID |
屬性值 (operation data) 的類型為 PVOID,這是迷你驅動程式所產生數據區塊之使用者模式緩衝區的指標。
評論
在屬性取得呼叫上:
如果應用程式以零長度緩衝區取得屬性呼叫,minidriver 必須傳回STATUS_BUFFER_OVERFLOW,並在 [Irp->IoStatus.Information] 字段中指定所需的緩衝區大小。 如果長度緩衝區為非零,則minidriver必須傳回STATUS_BUFFER_TOO_SMALL如果提供的緩衝區太小而無法用於數據區塊,否則minidriver會將其設定封裝到稍後可還原的數據區塊中。
迷你驅動程式有責任將數據完整性檢查新增至數據,例如唯一 GUID 來指出產生數據的迷你驅動程式、迴圈備援檢查 (CRC) 和標頭長度。
傳回的數據應該是輕量型的,而且只包含重建目前設定所需的資訊。
應用程式會將此屬性用於多層級復原、與其專案一起儲存等等。
在屬性集呼叫上:
迷你驅動程式必須確認數據的完整性,並檢查數據區塊大小是否在數據大小上限下(例如,拒絕超過特定大小的任何專案)。 它也必須驗證CRC和標頭長度。 minidriver 也必須快取要傳播給 CODECAPI_CURRENTCHANGELIST的任何變更。
需求
標頭:ksmedia.h中宣告的。 包含 ksmedia.h。