IWDFIoRequest2::GetEffectiveIoType-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. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren 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 GetEffectiveIoType-Methode gibt die Pufferzugriffsmethode zurück, die UMDF für die Datenpuffer der E/A-Anforderung verwendet, die die IWDFIoRequest2-Schnittstelle darstellt.

Syntax

WDF_DEVICE_IO_TYPE GetEffectiveIoType();

Rückgabewert

GetEffectiveIoType gibt einen WDF_DEVICE_IO_TYPE typisierten Wert zurück, der die Pufferzugriffsmethode identifiziert, die UMDF für die Datenpuffer der E/A-Anforderung verwendet.

Hinweise

Weitere Informationen zum Zugreifen auf Datenpuffer und wann Ihr Treiber GetEffectiveIoType verwenden sollte, finden Sie unter Zugreifen auf Datenpuffer in UMDF-Based Treibern.

Beispiele

Das folgende Codebeispiel zeigt, wie eine IQueueCallbackWrite::OnWrite-Rückruffunktion die Pufferzugriffsmethode einer E/A-Anforderung abrufen kann.

VOID
STDMETHODCALLTYPE
  CMyQueue::OnWrite(
    __in IWDFIoQueue *pWdfQueue,
    __in IWDFIoRequest *pWdfRequest,
    __in SIZE_T BytesToWrite
    )
{
    WDF_DEVICE_IO_TYPE currentIoType;

    //
    // Declare an IWDFIoRequest2 interface pointer and obtain the
    // IWDFIoRequest2 interface from the IWDFIoRequest interface.
    //
    CComQIPtr<IWDFIoRequest2> r2 = pWdfRequest;

    currentIoType = r2->GetEffectiveIoType();
...
}

Anforderungen

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

Weitere Informationen

IWDFIoRequest2

WDF_DEVICE_IO_TYPE (UMDF)