SRB_PROPOSE_DATA_FORMAT
類別驅動程式會發出此要求,以判斷數據流是否支援指定的數據格式。
傳回值
迷你驅動程式應該將下列其中一項設定為 SRB 中的狀態:
STATUS_SUCCESS
表示命令成功完成。
STATUS_NOT_IMPLEMENTED
表示迷你驅動程式不支援函式。
STATUS_NOT_SUPPORTED
表示迷你驅動程式不支持建議的格式。
STATUS_IO_DEVICE_ERROR
表示發生硬體失敗。
註解
當類別驅動程式收到 KSPROPERTY_CONNECTION_PROPOSEDATAFORMAT 要求時,它會使用此SRB程式代碼來判斷是否支持建議的格式。 類別驅動程式會以 CommandData 傳遞建議的數據格式。pSrb 指向的 OpenFormat 成員。 pSrb 指標指向HW_STREAM_REQUEST_BLOCK結構。
如果迷你驅動程式不支持數據格式,則會將 pSrb-Status> 設定為 STATUS_NOT_SUPPORTED。 如果迷你驅動程式能夠將數據流切換為指定的格式,則會將此字段設定為STATUS_SUCCESS。
如果 minidriver 能夠接受新的格式,則稍後的類別驅動程式可能會傳送迷你驅動程式格式變更,這是由 KSSTREAM_HEADER 結構中的 OptionsFlags 成員所表示。