SRB_PROPOSE_DATA_FORMAT

  • [アーティクル]

クラス ドライバーは、ストリームが特定のデータ形式をサポートしているかどうかを判断するために、この要求を発行します。

戻り値

ミニドライバーは、SRB の状態として次のいずれかを設定する必要があります。

STATUS_SUCCESS
コマンドが正常に完了したことを示します。

STATUS_NOT_IMPLEMENTED
ミニドライバーで関数がサポートされていないことを示します。

STATUS_NOT_SUPPORTED
提案された形式がミニドライバーでサポートされていないことを示します。

STATUS_IO_DEVICE_ERROR
ハードウェア障害が発生したことを示します。

Comments

クラス ドライバーは、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