Metodo IWDFDevice::CreateWdfFile (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione con UMDF.]
Il metodo CreateWdfFile crea un oggetto file da usare per un driver.
Sintassi
HRESULT CreateWdfFile(
[in, optional] LPCWSTR pcwszFileName,
[out] IWDFDriverCreatedFile **ppFile
);
Parametri
[in, optional] pcwszFileName
Puntatore a una stringa con terminazione NULL contenente il nome del file da cui creare un oggetto file. Questo parametro è facoltativo e, Il driver può passare NULL se il driver non deve creare l'oggetto file da un nome file. Se il driver deve specificare un nome, la stringa che il driver passa non deve contenere caratteri separatori di percorso ("/" o "\").
[out] ppFile
Puntatore a un buffer che riceve un puntatore all'interfaccia IWDFDriverCreatedFile per l'oggetto file creato dal driver.
Valore restituito
CreateWdfFile restituisce S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo restituisce uno dei codici di errore definiti in Winerror.h.
Commenti
Per informazioni su quando un driver UMDF usa CreateWdfFile per gestire I/O, vedere Creazione di un oggetto file per gestire I/O.
Per informazioni su quando un driver UMDF potrebbe usare CreateWdfFile per evitare uno squilibrio di creazione e chiusura delle notifiche a un driver, vedere Prevenzione di uno squilibrio di creazione e chiusura delle notifiche a un driver.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1.5 |
| Intestazione | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |