IWDFIoRequest::GetReadParameters-Methode (wudfddi.h)

  • Artikel

Warnung

UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.

Die GetReadParameters-Methode ruft die Anforderungsparameter für eine Lesetypanforderung ab.

Syntax

void GetReadParameters(
  [out, optional] SIZE_T   *pSizeInBytes,
  [out, optional] LONGLONG *pullOffset,
  [out, optional] ULONG    *pulKey
);

Parameter

[out, optional] pSizeInBytes

Ein Zeiger auf eine Variable, die die zu lesende Größe in Bytes empfängt. Um die Daten zum Lesen abzurufen, ruft der Treiber die IWDFIoRequest::GetOutputMemory-Methode auf.

Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn er die Informationen nicht benötigt.

[out, optional] pullOffset

Ein Zeiger auf eine Variable, die den Offset in Bytes empfängt, um mit dem Lesen vom Gerät oder der Datei auf dem Gerät zu beginnen. Wenn das Gerät keine absoluten Leseadressen unterstützt, kann pullOffset ignoriert werden. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Clientanwendungen geben diesen Wert im Offset - und OffsetHigh-Member der OVERLAPPED-Struktur an. Ein Zeiger auf OVERLAPPED wird in der Funktion Microsoft Win32 ReadFile oder ReadFileEx übergeben.

Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn er die Informationen nicht benötigt.

[out, optional] pulKey

Ein Zeiger auf eine Variable, die einen Schlüssel empfängt, den der Treiber verwenden kann, um die E/A-Anforderung auf eine weise zu sortieren, die der Treiber bestimmt.

Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn er die Informationen nicht benötigt.

Rückgabewert

Keine

Bemerkungen

Ein Aufruf von GetReadParameters schlägt fehl, wenn der Anforderungstyp kein Lesetyp ist.

Bei Geräten, die die Adressierung unterstützen (z. B. ein Datenträgergerät), ist der Wert, auf den der pullOffset-Parameter verweist, in der Regel der Byteoffset auf das Gerät. Bei Geräten, die keine Adressierung unterstützen (z. B. einen seriellen Port), kann der Treiber den Wert bei pullOffset ignorieren.

Obwohl der Treiber optional NULL für jeden der Parameter pSizeInBytes, pullOffset und pulKey angeben kann, muss der Treiber mindestens einen Parameter ohne NULL angeben, damit GetReadParameters erfolgreich ausgeführt werden kann.

Anforderungen

Anforderung Wert
Ende des Supports In UMDF 2.0 und höher nicht verfügbar.
Zielplattform Desktop
UMDF-Mindestversion 1.5
Kopfzeile wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Weitere Informationen