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。

如果微型驱动程序能够接受新格式,则类驱动程序稍后可能会向微型驱动程序发送格式更改,这由 KSSTREAM_HEADER 结构中的 OptionsFlags 成员指示。

另请参阅

SRB_SET_DATA_FORMAT

SRB_GET_DATA_FORMAT