Método IWDFDevice2::GetDeviceStackIoTypePreference (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción a UMDF.]
El método GetDeviceStackIoTypePreference recupera los métodos de acceso al búfer que usa el marco para un dispositivo.
Sintaxis
void GetDeviceStackIoTypePreference(
[out] WDF_DEVICE_IO_TYPE *ReadWritePreference,
[out] WDF_DEVICE_IO_TYPE *IoControlPreference
);
Parámetros
[out] ReadWritePreference
Puntero a una ubicación asignada por el controlador que recibe un valor de tipo WDF_DEVICE_IO_TYPE. Este valor identifica el método de acceso al búfer que usa el marco para las solicitudes de lectura y escritura de un dispositivo.
[out] IoControlPreference
Puntero a una ubicación asignada por el controlador que recibe un valor de tipo WDF_DEVICE_IO_TYPE. Este valor que identifica el método de acceso al búfer que usa el marco para las solicitudes de control de E/S de un dispositivo.
Valor devuelto
Ninguno
Observaciones
Si el controlador llama a GetDeviceStackIoTypePreference antes de que el administrador de PnP haya cargado todos los controladores del dispositivo, es posible que los valores que GetDeviceStackIoTypePreference recupere no sean los valores que realmente usa.
Para obtener más información sobre cómo elige el marco de trabajo un método de acceso de búfer, vea Cómo umDF elige un método de acceso de búfer para una solicitud de E/S.
Ejemplos
En el ejemplo de código siguiente se recuperan los métodos de acceso al búfer que usa el marco para un dispositivo.
WDF_DEVICE_IO_TYPE ReadWriteAccessMethod;
WDF_DEVICE_IO_TYPE IoControlAccessMethod;
Device2->GetDeviceStackIoTypePreference(&ReadWriteAccessMethod,
&IoControlAccessMethod);
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.9 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |