Método IWDFDevice::CreateWdfFile (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con 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 con UMDF.
El método CreateWdfFile crea un objeto de archivo para que un controlador lo use.
Sintaxis
HRESULT CreateWdfFile(
[in, optional] LPCWSTR pcwszFileName,
[out] IWDFDriverCreatedFile **ppFile
);
Parámetros
[in, optional] pcwszFileName
Puntero a una cadena terminada en NULL que contiene el nombre del archivo desde el que se va a crear un objeto de archivo. Este parámetro es opcional. El controlador puede pasar NULL si el controlador no tiene que crear el objeto de archivo a partir de un nombre de archivo. Si el controlador debe proporcionar un nombre, la cadena que el controlador pasa no debe contener ningún carácter separador de ruta de acceso ("/" o "\").
[out] ppFile
Puntero a un búfer que recibe un puntero a la interfaz IWDFDriverCreatedFile para el objeto de archivo creado por el controlador.
Valor devuelto
CreateWdfFile devuelve S_OK si la operación se realiza correctamente. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h.
Comentarios
Para obtener información sobre cuándo un controlador UMDF usa CreateWdfFile para controlar la E/S, vea Crear un objeto de archivo para controlar la E/S.
Para obtener información sobre cuándo un controlador UMDF puede usar CreateWdfFile para evitar un desequilibrio de creación y cierre de notificaciones a un controlador, consulte Prevención de un desequilibrio de creación y cierre de notificaciones en un controlador.
Requisitos
Requisito | Value |
---|---|
Finalización del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
Plataforma de destino | Escritorio |
Versión mínima de UMDF | 1.5 |
Encabezado | wudfddi.h (incluya Wudfddi.h) |
Archivo DLL | WUDFx.dll |