Передача изображения или музыкального файла на устройство
Одной из наиболее распространенных операций, выполняемых приложением, является передача содержимого на подключенное устройство.
Передача содержимого выполняется с помощью интерфейсов, описанных в следующей таблице.
| Интерфейс | Описание |
|---|---|
| Интерфейс IPortableDeviceContent | Предоставляет доступ к методам, зависящим от содержимого. |
| Интерфейс IPortableDeviceDataStream | Используется при записи содержимого на устройство. |
| Интерфейс IPortableDeviceValues | Используется для получения свойств, описывающих содержимое. |
| Интерфейс IStream | Используется для упрощения чтения содержимого и записи на устройство. |
Функция TransferContentToDevice в модуле ContentTransfer.cpp примера приложения демонстрирует, как приложение может передавать содержимое с компьютера на подключенное устройство. В этом конкретном примере переданное содержимое может быть файлом, содержащим изображение, музыку или контактные данные.
Первая задача, выполняемая TransferContentToDevice функцией, — предложить пользователю ввести идентификатор объекта, который идентифицирует передаваемый объект.
HRESULT hr = S_OK;
WCHAR szSelection[81] = {0};
WCHAR szFilePath[MAX_PATH] = {0};
DWORD cbOptimalTransferSize = 0;
CComPtr<IStream> pFileStream;
CComPtr<IPortableDeviceDataStream> pFinalObjectDataStream;
CComPtr<IPortableDeviceValues> pFinalObjectProperties;
CComPtr<IPortableDeviceContent> pContent;
CComPtr<IStream> pTempStream; // Temporary IStream which we use to QI for IPortableDeviceDataStream
// Prompt user to enter an object identifier for the parent object on the device to transfer.
printf("Enter the identifer of the parent object which the file will be transferred under.\n>");
hr = StringCbGetsW(szSelection,sizeof(szSelection));
if (FAILED(hr))
{
printf("An invalid object identifier was specified, aborting content transfer\n");
}
Второй задачей, TransferContentToDevice выполняемой функцией, является создание объекта IPortableDeviceContent путем вызова метода IPortableDevice::Content .
if (SUCCEEDED(hr))
{
hr = pDevice->Content(&pContent);
if (FAILED(hr))
{
printf("! Failed to get IPortableDeviceContent from IPortableDevice, hr = 0x%lx\n",hr);
}
}
Следующая задача, выполняемая TransferContentToDevice функцией, — создание диалогового окна FileOpen , с помощью которого пользователь может указать расположение и имя передаваемого файла.
if (SUCCEEDED(hr))
{
OPENFILENAME OpenFileNameInfo = {0};
OpenFileNameInfo.lStructSize = sizeof(OPENFILENAME);
OpenFileNameInfo.hwndOwner = NULL;
OpenFileNameInfo.lpstrFile = szFilePath;
OpenFileNameInfo.nMaxFile = ARRAYSIZE(szFilePath);
OpenFileNameInfo.lpstrFilter = pszFileTypeFilter;
OpenFileNameInfo.nFilterIndex = 1;
OpenFileNameInfo.Flags = OFN_PATHMUSTEXIST | OFN_FILEMUSTEXIST;
OpenFileNameInfo.lpstrDefExt = pszDefaultFileExtension;
if (GetOpenFileName(&OpenFileNameInfo) == FALSE)
{
printf("The transfer operation was canceled.\n");
hr = E_ABORT;
}
}
Функция TransferContentToDevice передает строку фильтра (wszFileTypeFilter) методу GetOpenFileName, который определяет тип файлов, которые пользователь может выбрать. См. функцию DoMenu в модуле WpdApiSample.cpp, например три разных фильтра, разрешенных примером.
После того как пользователь идентифицирует определенный файл для передачи на устройство, TransferContentToDevice функция открывает этот файл в качестве объекта IStream и извлекает свойства, необходимые для завершения передачи.
if (SUCCEEDED(hr))
{
// Open the selected file as an IStream. This will simplify reading the
// data and writing to the device.
hr = SHCreateStreamOnFile(szFilePath, STGM_READ, &pFileStream);
if (SUCCEEDED(hr))
{
// Get the required properties needed to properly describe the data being
// transferred to the device.
hr = GetRequiredPropertiesForContentType(guidContentType, // Content type of the data
szSelection, // Parent to transfer the data under
szFilePath, // Full file path to the data file
pFileStream, // Open IStream that contains the data
&pFinalObjectProperties); // Returned properties describing the data
if (FAILED(hr))
{
printf("! Failed to get required properties needed to transfer a file to the device, hr = 0x%lx\n", hr);
}
}
if (FAILED(hr))
{
printf("! Failed to open file named (%ws) to transfer to device, hr = 0x%lx\n",szFilePath, hr);
}
}
Необходимые свойства извлекаются путем вызова вспомогательнойGetRequiredPropertiesForContentType функции, которая работает с объектом IStream. Вспомогаемая GetRequiredPropertiesForContentType функция создает объект IPortableDeviceValues , извлекает свойства из следующего списка и добавляет их в этот объект.
- Идентификатор родительского объекта
- Размер потока в байтах
- Имя файла содержимого
- Имя содержимого (имя файла без расширения)
- Тип контента (изображение, звук или контакт)
- Формат содержимого (JFIF, WMA или vCard2)
В примере приложения используются извлеченные свойства для создания нового содержимого на устройстве. Это выполняется на трех этапах:
- Приложение вызывает метод IPortableDeviceContent::CreateObjectWithPropertiesAndData для создания объекта IStream на устройстве.
- Приложение использует этот объект для получения объекта IPortableDeviceDataStream из драйвера WPD.
- Приложение использует новый объект IPortableDeviceDataStream для записи содержимого на устройство (с помощью вспомогательной функции StreamCopy). Вспомогающая функция записывает данные из исходного файла в поток, возвращенный IPortableDeviceContent::CreateObjectWithPropertiesAndData.
- Приложение завершает операцию путем вызова метода Commit в целевом потоке.
// 4) Transfer for the content to the device
if (SUCCEEDED(hr))
{
hr = pContent->CreateObjectWithPropertiesAndData(pFinalObjectProperties, // Properties describing the object data
&pTempStream, // Returned object data stream (to transfer the data to)
&cbOptimalTransferSize, // Returned optimal buffer size to use during transfer
NULL);
// Once we have a the IStream returned from CreateObjectWithPropertiesAndData,
// QI for IPortableDeviceDataStream so we can use the additional methods
// to get more information about the object (i.e. The newly created object
// identifier on the device)
if (SUCCEEDED(hr))
{
hr = pTempStream->QueryInterface(IID_PPV_ARGS(&pFinalObjectDataStream));
if (FAILED(hr))
{
printf("! Failed to QueryInterface for IPortableDeviceDataStream, hr = 0x%lx\n",hr);
}
}
// Since we have IStream-compatible interfaces, call our helper function
// that copies the contents of a source stream into a destination stream.
if (SUCCEEDED(hr))
{
DWORD cbTotalBytesWritten = 0;
hr = StreamCopy(pFinalObjectDataStream, // Destination (The Object to transfer to)
pFileStream, // Source (The File data to transfer from)
cbOptimalTransferSize, // The driver specified optimal transfer buffer size
&cbTotalBytesWritten); // The total number of bytes transferred from file to the device
if (FAILED(hr))
{
printf("! Failed to transfer object to device, hr = 0x%lx\n",hr);
}
}
else
{
printf("! Failed to get IStream (representing destination object data on the device) from IPortableDeviceContent, hr = 0x%lx\n",hr);
}
// After transferring content to the device, the client is responsible for letting the
// driver know that the transfer is complete by calling the Commit() method
// on the IPortableDeviceDataStream interface.
if (SUCCEEDED(hr))
{
hr = pFinalObjectDataStream->Commit(0);
if (FAILED(hr))
{
printf("! Failed to commit object to device, hr = 0x%lx\n",hr);
}
}
// Some clients may want to know the object identifier of the newly created
// object. This is done by calling GetObjectID() method on the
// IPortableDeviceDataStream interface.
if (SUCCEEDED(hr))
{
PWSTR pszNewlyCreatedObject = NULL;
hr = pFinalObjectDataStream->GetObjectID(&pszNewlyCreatedObject);
if (SUCCEEDED(hr))
{
printf("The file '%ws' was transferred to the device.\nThe newly created object's ID is '%ws'\n",szFilePath ,pszNewlyCreatedObject);
}
if (FAILED(hr))
{
printf("! Failed to get the newly transferred object's identifier from the device, hr = 0x%lx\n",hr);
}
// Free the object identifier string returned from the GetObjectID() method.
CoTaskMemFree(pszNewlyCreatedObject);
pszNewlyCreatedObject = NULL;
}
}
Связанные темы