IDiscRecorder2Ex::GetModePage-Methode (imapi2.h)

Artikel
08/24/2023

Ruft die angegebene Modusseite vom Gerät ab.

Syntax

HRESULT GetModePage(
  [in]  IMAPI_MODE_PAGE_TYPE         requestedModePage,
  [in]  IMAPI_MODE_PAGE_REQUEST_TYPE requestType,
  [out] BYTE                         **modePageData,
  [out] ULONG_IMAPI2_MODE_PAGE       *byteSize
);

Parameter

[in] requestedModePage

Abzurufende Modusseite. Mögliche Werte finden Sie unter IMAPI_MODE_PAGE_TYPE Enumerationstyp.

[in] requestType

Typ der abzurufenden Seitendaten im Modus, z. B. die aktuellen Einstellungen oder die Einstellungen, die schreibfähig sind. Mögliche Werte finden Sie unter IMAPI_MODE_PAGE_REQUEST_TYPE Enumerationstyp.

[out] modePageData

Datenpuffer, der die Modusseite enthält. Ausführliche Informationen zum Inhalt des Datenpuffers finden Sie unter dem Befehl MODE SENSE (10) in der neuesten Überarbeitung der MMC-Spezifikation unter ftp://ftp.t10.org/t10/drafts/mmc5.

Diese Methode entfernt Headerinformationen und andere Nichtseitendaten, bevor der Puffer zurückgegeben wird.

Wenn Sie fertig sind, rufen Sie die CoTaskMemFree-Funktion auf, um den Arbeitsspeicher freizugeben.

[out] byteSize

Größe des modePageData-Datenpuffers in Byte.

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode	Beschreibung
E_INVALIDARG	Mindestens ein Argument ist ungültig. Wert: 0x80070057
E_POINTER	Der Zeiger ist ungültig. Wert: 0x80004003
E_FAIL	Unspezifizierter Fehler. Wert: 0x80004005
E_OUTOFMEMORY	Fehler beim Zuordnen des erforderlichen Arbeitsspeichers. Wert: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	Das Gerät konnte den Befehl nicht innerhalb des Timeoutzeitraums annehmen. Dies kann darauf zurückzuführen sein, dass das Gerät in einen inkonsistenten Zustand versetzt wurde, oder der Timeoutwert für den Befehl muss möglicherweise erhöht werden. Wert: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	Das Gerät hat unerwartete oder ungültige Daten für einen Befehl gemeldet. Wert: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	Das Medium wird kopfüber eingefügt. Wert: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	Das Laufwerk hat gemeldet, dass es gerade bereit ist. Versuchen Sie es später erneut. Wert: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	Das Gerät enthält keine Medien. Wert: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	Die Medien werden derzeit formatiert. Warten Sie, bis das Format abgeschlossen ist, bevor Sie versuchen, die Medien zu verwenden. Wert: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	Das Laufwerk hat gemeldet, dass es einen zeitintensiven Vorgang ausführt, z. B. das Beenden eines Schreibvorgangs. Das Laufwerk kann für einen längeren Zeitraum unbrauchbar sein. Wert: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	Fehler beim Schreiben, weil das Laufwerk daten nicht schnell genug empfangen hat, um mit dem Schreiben fortzufahren. Wenn Sie die Quelldaten auf den lokalen Computer verschieben, die Schreibgeschwindigkeit verringern oder die Einstellung "pufferunterlauffrei" aktivieren, kann dieses Problem behoben werden. Wert: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	Die Medien sind nicht kompatibel oder haben ein unbekanntes physisches Format. Wert: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	Die DVD-Struktur ist nicht vorhanden. Dies kann durch inkompatibles Verwendetes Laufwerk/Medium verursacht werden. Wert: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	Das Gerät hat gemeldet, dass die angeforderte Modusseite (und der Typ) nicht vorhanden sind. Wert: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	Das Laufwerk meldete, dass die Kombination von Parametern, die auf der Modusseite für einen MODE SELECT-Befehl bereitgestellt wurden, nicht unterstützt wurde. Wert: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	Das Laufwerk hat gemeldet, dass die Medien schreibgeschützt sind. Wert: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	Die Geschwindigkeit der Medien ist mit dem Gerät nicht kompatibel. Dies kann durch die Verwendung von Medien mit höherer oder niedrigerer Geschwindigkeit als der vom Gerät unterstützte Geschwindigkeitsbereich verursacht werden. Wert: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	Das angegebene Handle ist ungültig. Wert: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	Die angegebene Netzwerkressource oder das angegebene Gerät ist nicht mehr verfügbar. Wert: 55
E_IMAPI_RECORDER_LOCKED	Das gerät, das diesem Recorder während des letzten Vorgangs zugeordnet ist, wurde ausschließlich gesperrt, sodass dieser Vorgang fehlgeschlagen ist. Wert: 0xC0AA0210
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	Das Gerät hat gemeldet, dass die angeforderte Modusseite (und der Typ) nicht vorhanden sind. Wert: 0xC0AA0201

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	imapi2.h

Weitere Informationen

IDiscRecorder2Ex

IDiscRecorder2Ex::GetSupportedModePages

IDiscRecorder2Ex::SetModePage

IMAPI_MODE_PAGE_REQUEST_TYPE

IMAPI_MODE_PAGE_TYPE

Freigeben über