デバイスから PC へのコンテンツの転送
WPD アプリケーションによって実行される一般的な操作の 1 つは、接続されたデバイスから PC へのコンテンツの転送です。
コンテンツ転送は、次の表で説明するインターフェイスを使用して実行されます。
| インターフェイス | 説明 |
|---|---|
| IPortableDeviceContent インターフェイス | IPortableDeviceProperties インターフェイスへのアクセスを提供します。 |
| IPortableDeviceProperties インターフェイス | プロパティ固有のメソッドへのアクセスを提供します。 |
| IPortableDeviceResources インターフェイス | 指定されたプロファイルのプロパティ キーを格納するために使用されます。 |
| IStream インターフェイス | データの読み取りと書き込みに使用されます。 |
サンプル アプリケーションの ContentTransfer.cpp モジュールの関数は TransferContentFromDevice 、アプリケーションが接続されているデバイスから PC に連絡先情報を転送する方法を示しています。
関数によって実行される最初の TransferContentFromDevice タスクは、(コンテンツが転送される) デバイス上の親オブジェクトのオブジェクト識別子を入力するようにユーザーに求めます。
HRESULT hr = S_OK;
WCHAR szSelection[81] = {0};
CComPtr<IPortableDeviceContent> pContent;
CComPtr<IPortableDeviceResources> pResources;
CComPtr<IPortableDeviceProperties> pProperties;
CComPtr<IStream> pObjectDataStream;
CComPtr<IStream> pFinalFileStream;
DWORD cbOptimalTransferSize = 0;
CAtlStringW strOriginalFileName;
if (pDevice == NULL)
{
printf("! A NULL IPortableDevice interface pointer was received\n");
return;
}
// Prompt user to enter an object identifier on the device to transfer.
printf("Enter the identifer of the object you wish to transfer.\n>");
hr = StringCbGetsW(szSelection,sizeof(szSelection));
if (FAILED(hr))
{
printf("An invalid object identifier was specified, aborting content transfer\n");
}
次の手順では、サンプルがコンテンツ固有のメソッドにアクセスするために使用する IPortableDeviceContent オブジェクトを取得します。
if (SUCCEEDED(hr))
{
hr = pDevice->Content(&pContent);
if (FAILED(hr))
{
printf("! Failed to get IPortableDeviceContent from IPortableDevice, hr = 0x%lx\n",hr);
}
}
次の手順では、サンプルがリソース固有のメソッドにアクセスするために使用する IPortableDeviceResources オブジェクトを取得します。
if (SUCCEEDED(hr))
{
hr = pContent->Transfer(&pResources);
if (FAILED(hr))
{
printf("! Failed to get IPortableDeviceResources from IPortableDeviceContent, hr = 0x%lx\n",hr);
}
}
次の手順は、サンプルがデバイスから転送するデータを読み取るために使用する IStream オブジェクトの取得です。
if (SUCCEEDED(hr))
{
hr = pResources->GetStream(szSelection, // Identifier of the object we want to transfer
WPD_RESOURCE_DEFAULT, // We are transferring the default resource (which is the entire object's data)
STGM_READ, // Opening a stream in READ mode, because we are reading data from the device.
&cbOptimalTransferSize, // Driver supplied optimal transfer size
&pObjectDataStream);
if (FAILED(hr))
{
printf("! Failed to get IStream (representing object data on the device) from IPortableDeviceResources, hr = 0x%lx\n",hr);
}
}
次の手順は、デバイス上のオブジェクトのファイル名を取得することです。 この文字列は、対応するファイル名を PC に作成するために使用されます。 オブジェクトにデバイス上のファイル名がない場合、オブジェクトの識別子は文字列に変換され、コピー先のファイル名の作成に使用されます。
if (SUCCEEDED(hr))
{
hr = pContent->Properties(&pProperties);
if (SUCCEEDED(hr))
{
hr = GetStringValue(pProperties,
szSelection,
WPD_OBJECT_ORIGINAL_FILE_NAME,
strOriginalFileName);
if (FAILED(hr))
{
printf("! Failed to read WPD_OBJECT_ORIGINAL_FILE_NAME on object '%ws', hr = 0x%lx\n", szSelection, hr);
strOriginalFileName.Format(L"%ws.data", szSelection);
printf("* Creating a filename '%ws' as a default.\n", (PWSTR)strOriginalFileName.GetString());
// Set the HRESULT to S_OK, so we can continue with our newly generated
// temporary file name.
hr = S_OK;
}
}
else
{
printf("! Failed to get IPortableDeviceProperties from IPortableDeviceContent, hr = 0x%lx\n", hr);
}
}
この後、サンプルは宛先 IStream オブジェクトを作成します。
if (SUCCEEDED(hr))
{
hr = SHCreateStreamOnFile(strOriginalFileName, STGM_CREATE|STGM_WRITE, &pFinalFileStream);
if (FAILED(hr))
{
printf("! Failed to create a temporary file named (%ws) to transfer object (%ws), hr = 0x%lx\n",(PWSTR)strOriginalFileName.GetString(), szSelection, hr);
}
}
最後に、ソース IStream オブジェクトが PC のコピー先にコピーされます。
if (SUCCEEDED(hr))
{
DWORD cbTotalBytesWritten = 0;
// Since we have IStream-compatible interfaces, call our helper function
// that copies the contents of a source stream into a destination stream.
hr = StreamCopy(pFinalFileStream, // Destination (The Final File to transfer to)
pObjectDataStream, // Source (The Object's data to transfer from)
cbOptimalTransferSize, // The driver specified optimal transfer buffer size
&cbTotalBytesWritten); // The total number of bytes transferred from device to the finished file
if (FAILED(hr))
{
printf("! Failed to transfer object from device, hr = 0x%lx\n",hr);
}
else
{
printf("* Transferred object '%ws' to '%ws'.\n", szSelection, (PWSTR)strOriginalFileName.GetString());
}
}
関連トピック