共用方式為


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 成員所表示。

另請參閱

SRB_SET_DATA_FORMAT

SRB_GET_DATA_FORMAT