IMDSPDirectTransfer::TransferToDevice メソッド (mswmdm.h)

[アーティクル]
03/15/2023

TransferToDevice メソッドは、コンテンツ転送コンテンツをサービスプロバイダーに委任するために、Windows Media デバイスマネージャーによって呼び出されます。ソースは、ファイルまたは操作インターフェイスとして指定できます。

構文

HRESULT TransferToDevice(
  [in]  LPCWSTR        pwszSourceFilePath,
  [in]  IWMDMOperation *pSourceOperation,
  [in]  UINT           fuFlags,
  [in]  LPWSTR         pwszDestinationName,
  [in]  IWMDMMetaData  *pSourceMetaData,
  [in]  IWMDMProgress  *pTransferProgress,
  [out] IMDSPStorage   **ppNewObject
);

パラメーター

[in] pwszSourceFilePath

ソースファイル名。 WMDM_CONTENT_OPERATIONINTERFACEが指定されている場合、このパラメーターに含まれる値は無視する必要があります。

[in] pSourceOperation

ソースとして機能する操作インターフェイスポインター。 WMDM_CONTENT_OPERATIONINTERFACEが指定されていない限り、このパラメーターに含まれる値は無視する必要があります。

[in] fuFlags

このメソッドの動作に影響を与えるフラグ。 fuFlags パラメーターは、次のいずれかの値である必要があります。

値	説明
WMDM_CONTENT_FILE	ソースはファイルです。
WMDM_CONTENT_FOLDER	ソースはフォルダーです。
WMDM_FILE_CREATE_OVERWRITE	コピー先ファイルが既に存在する場合は上書きします。

[in] pwszDestinationName

この名前のデバイスにコンテンツを転送する必要があります。このパラメーターは必須です。

[in] pSourceMetaData

メタデータインターフェイスポインター。メタデータオブジェクトには、ソースプロパティが含まれています。このパラメーターは省略可能です。

[in] pTransferProgress

進行状況コールバックインターフェイス。サービスプロバイダーは、転送の進行中に情報を更新する必要があります。このパラメーターは省略可能です。

[out] ppNewObject

新しく作成されたストレージオブジェクト。このパラメーターは省略可能です。呼び出し元が新しいオブジェクトを返す必要がない場合は 、NULL を 指定できます。

戻り値

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	次のいずれかが当てはまります。 pwszSourceFileName と pSourceOperation の両方が指定されています。 pwszDestinationName が指定されていません。 fuFlags が無効です。
HRESULT_FROM_WIN32(ERROR_DISK_FULL)	ディスクに十分な空き領域がありません。
HRESULT_FROM_WIN32(ERROR_FILE_EXISTS)	ファイルは既に存在し、WMDM_FILE_CREATE_OVERWRITEが指定されていません。デバイスで重複するファイル名が許可されている場合、これは許容される可能性があり、このエラーを返す必要はありません。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	指定されたコンテンツの転送は、デバイスではサポートされていません。

注釈

Windows Media デバイスマネージャー転送のたびに IMDSPDirectTransfer インターフェイスに対するクエリが実行されます。

サービスプロバイダーが IMDSPDirectTransfer インターフェイスをサポートしている場合、Windows Media デバイスマネージャーはコンテンツ転送をサービスプロバイダーに委任するだけです。この場合、Windows Media デバイスマネージャーは、サービスプロバイダーに送信する前にコンテンツの処理を行いません。サービスプロバイダーは、ソースを完全に制御します。

サービスプロバイダーが IMDSPDirectTransfer インターフェイスをサポートしていない場合、Windows Media デバイスマネージャーはソースファイルを処理し、バイトパケットをサービスプロバイダーに送信します。さらに、保護されたコンテンツの場合、Windows Media デバイスマネージャーはセキュリティで保護されたコンテンツプロバイダーを呼び出して、サービスプロバイダーに送信する前にコンテンツを処理します。

IMDSPDirectTransfer がサポートされている場合、Windows Media デバイスマネージャーはコンテンツの処理をサービスプロバイダーに委任します。これにより、サービスプロバイダーはコンテンツを柔軟に処理できます。この場合、サービスプロバイダーは保護されたコンテンツの処理を担当します。