IMDSPDirectTransfer::TransferToDevice-Methode (mswmdm.h)

Artikel
03/13/2024

Die TransferToDevice-Methode wird von Windows Media Geräte-Manager aufgerufen, um Inhalte der Inhaltsübertragung an den Dienstanbieter zu delegieren. Die Quelle kann entweder als Datei oder als Vorgangsschnittstelle angegeben werden.

Syntax

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

Parameter

[in] pwszSourceFilePath

Quelldateiname. Der in diesem Parameter enthaltene Wert sollte ignoriert werden, wenn WMDM_CONTENT_OPERATIONINTERFACE angegeben wird.

[in] pSourceOperation

Vorgangsschnittstellenzeiger, der als Quelle dient. Der in diesem Parameter enthaltene Wert sollte ignoriert werden, es sei denn, WMDM_CONTENT_OPERATIONINTERFACE angegeben ist.

[in] fuFlags

Flags, die das Verhalten dieser Methode beeinflussen. Der fuFlags-Parameter muss einer der folgenden Werte sein.

Wert	BESCHREIBUNG
WMDM_CONTENT_FILE	Die Quelle ist eine Datei.
WMDM_CONTENT_FOLDER	Die Quelle ist ein Ordner.
WMDM_FILE_CREATE_OVERWRITE	Überschreiben Sie die Zieldatei, wenn sie bereits vorhanden ist.

[in] pwszDestinationName

Inhalte sollten mit diesem Namen auf das Gerät übertragen werden. Dieser Parameter ist erforderlich.

[in] pSourceMetaData

Metadatenschnittstellenzeiger. Das Metadatenobjekt enthält die Quelleigenschaften. Dieser Parameter ist optional.

[in] pTransferProgress

Status-Rückrufschnittstelle. Der Dienstanbieter sollte die Informationen während des Fortschritts der Übertragung aktualisieren. Dieser Parameter ist optional.

[out] ppNewObject

Neu erstelltes Speicherobjekt. Dieser Parameter ist optional. Dies kann NULL sein, wenn für den Aufrufer das neue Objekt nicht zurückgegeben werden muss.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG	Es trifft eine der folgenden Bedingungen zu: Sowohl pwszSourceFileName als auch pSourceOperation werden angegeben. pwszDestinationName ist nicht angegeben. fuFlags ist ungültig.
HRESULT_FROM_WIN32(ERROR_DISK_FULL)	There is not enough space on the disk.
HRESULT_FROM_WIN32(ERROR_FILE_EXISTS)	Die Datei ist bereits vorhanden, und WMDM_FILE_CREATE_OVERWRITE nicht angegeben wurde. Wenn das Gerät doppelte Dateinamen zulässt, kann dies akzeptabel sein, und dieser Fehler muss nicht zurückgegeben werden.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Die Übertragung des angegebenen Inhalts wird auf dem Gerät nicht unterstützt.

Hinweise

Windows Media Geräte-Manager Abfragen für die IMDSPDirectTransfer-Schnittstelle während jeder Übertragung.

Wenn der Dienstanbieter die IMDSPDirectTransfer-Schnittstelle unterstützt, delegiert Windows Media Geräte-Manager die Inhaltsübertragung einfach an den Dienstanbieter. In diesem Fall führt Windows Media Geräte-Manager keine Verarbeitung der Inhalte durch, bevor sie an den Dienstanbieter gesendet werden. Der Dienstanbieter erhält die vollständige Kontrolle über die Quelle.

Wenn der Dienstanbieter die IMDSPDirectTransfer-Schnittstelle nicht unterstützt, verarbeitet Windows Media Geräte-Manager die Quelldateien und sendet Bytepakete an den Dienstanbieter. Darüber hinaus ruft Windows Media Geräte-Manager für geschützte Inhalte den Anbieter für sichere Inhalte auf, um die Inhalte vor dem Senden an den Dienstanbieter zu verarbeiten.

Wenn IMDSPDirectTransfer unterstützt wird, delegiert Windows Media Geräte-Manager die Verarbeitung des Inhalts an den Dienstanbieter. Dies bietet dem Dienstanbieter Flexibilität bei der Verarbeitung der Inhalte. In diesem Fall ist der Dienstanbieter für den Umgang mit den geschützten Inhalten verantwortlich.