CDROM_SET_STREAMING 結構 (ntddcdrm.h)

  • 發行項

CDROM_SET_SPEED 結構會與 IOCTL_CDROM_SET_SPEED 要求搭配使用，以在連續傳輸期間設定CD-ROM磁碟驅動器的軸速度，以允許某些數據遺失。

語法

typedef struct _CDROM_SET_STREAMING {
  CDROM_SPEED_REQUEST RequestType;
  ULONG               ReadSize;
  ULONG               ReadTime;
  ULONG               WriteSize;
  ULONG               WriteTime;
  ULONG               StartLba;
  ULONG               EndLba;
  WRITE_ROTATION      RotationControl;
  BOOLEAN             RestoreDefaults;
  BOOLEAN             SetExact;
  BOOLEAN             RandomAccess;
  BOOLEAN             Persistent;
} CDROM_SET_STREAMING, *PCDROM_SET_STREAMING;

成員

RequestType

CDROM_SPEED_REQUEST型別值，指出設定軸速度時要使用的多媒體命令。

ReadSize

要在每個時間單位中讀取的 KB 數，其中 ReadTime 會指定一個時間單位。 ReadSize 中0xFFFF的值會選取磁碟驅動器的最佳數據傳送速率。

ReadTime

要讀取 ReadSize 數據之毫秒數。

WriteSize

要在每個時間單位中寫入的 KB 數，其中一個時間單位是由 WriteTime 所定義。 WriteSize 中0xFFFF的值會選取磁碟驅動器的最佳數據傳送速率。

WriteTime

要寫入 WriteSize KB 數據之毫秒數。

StartLba

IOCTL_CDROM_SET_SPEED要求的第一個邏輯區塊位址，以位元組為單位。

EndLba

IOCTL_CDROM_SET_SPEED要求的最後一個邏輯區塊位址，以位元組為單位。

RotationControl

WRITE_ROTATION型別值，指出裝置是否會使用CLV (常數線性速度寫入媒體，) 旋轉或 CLA (常數角度速度) 旋轉。

RestoreDefaults

BOOLEAN 值，當 為 TRUE 時，會指示 CD-ROM 類別驅動程式以預設的軸速度執行 CD-ROM 磁碟驅動器。 FALSE 值會指示類別驅動程式從這個結構的 ReadSize、ReadTime、WriteSize 和 WriteTime 成員計算軸速度。

SetExact

BOOLEAN 值，當為 TRUE 時，會指示 CD-ROM 類別驅動程式將 CD-ROM 磁碟驅動器設定為此結構之 ReadSize、ReadTime、WriteSize 和 WriteTime 成員所指定的確切速度。 如果類別驅動程式無法將軸速度設定為這些成員所指定的確切值，則要求會失敗。 SetExact 中的 FALSE 值會指示類別驅動程式盡可能讓磁碟驅動器的軸速度符合 ReadSize、ReadTime、WriteSize 和 WriteTime 所指定的速度;如果磁碟驅動器無法以這些成員指定的確切值執行，類別驅動程式就不會失敗要求。

RandomAccess

BOOLEAN 值，當 為 TRUE 時，會指示 CD-ROM 類別驅動程式設定 CD-ROM 磁碟驅動器，讓它在讀取和寫入作業之間來回切換，以將效能最大化 (數據輸送量) ，即使在讀取和寫入作業之間切換，還是會導致特定讀取或寫入作業變慢。 換句話說，RandomAccess 中的 TRUE 值可讓磁碟驅動器降低某些個別讀取和寫入作業的速度，以確保數據傳輸的整體效能更好。 FALSE 值會指示 CD-ROM 類別驅動程式設定 CD-ROM 磁碟驅動器，以確保彼此無關的讀取和寫入作業速度。 每個作業的數據傳輸速率都是固定的，而且磁碟驅動器不會改變速度以達到效能提升。

Persistent

BOOLEAN 值，當 為 TRUE 時，會指示 CD-ROM 類別驅動程式設定 CD-ROM 磁碟驅動器，以在使用者變更媒體時還原預設速度。 FALSE 值會指示 CD-ROM 類別驅動程式設定 CD-ROM 磁碟驅動器以維持其速度，直到電腦重新啟動或類別驅動程式使用另一個命令變更速度為止。

規格需求

需求 值
標頭 ntddcdrm.h (包含 Ntddcdrm.h)

另請參閱

CDROM_SET_SPEED

CDROM_SPEED_REQUEST

IOCTL_CDROM_SET_SPEED

WRITE_ROTATION