IWDFIoRequest::GetReadParameters-Methode (wudfddi.h)
Warnung
UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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 die Informationen nicht erforderlich sind.
[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, können 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 Microsoft Win32-ReadFile-- oder ReadFileEx--Funktion übergeben.
Dieser Parameter ist optional. Der Treiber kann NULL- übergeben, wenn die Informationen nicht erforderlich sind.
[out, optional] pulKey
Ein Zeiger auf eine Variable, die einen Schlüssel empfängt, den der Treiber verwenden kann, um die E/A-Anforderung so zu sortieren, dass der Treiber bestimmt.
Dieser Parameter ist optional. Der Treiber kann NULL- übergeben, wenn die Informationen nicht erforderlich sind.
Rückgabewert
Nichts
Bemerkungen
Ein Aufruf von GetReadParameters schlägt fehl, wenn der Anforderungstyp kein Lesetyp ist.
Für Geräte, 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. Für Geräte, die keine Adressierung unterstützen (z. B. einen seriellen Anschluss), kann der Treiber den Wert bei pullOffset-ignorieren.
Obwohl der Treiber optional NULL- für jeden pSizeInBytes-, pullOffset-und pulKey--Parameter angeben kann, muss der Treiber mindestens einen nicht-NULL- Parameter angeben, damit GetReadParameter s erfolgreich ausgeführt werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |