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. Non vengono aggiunte nuove funzionalità 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, vedi Introduzione a 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 un NULLstringa con terminazione contenente il nome del file da cui creare un oggetto file. Questo parametro è facoltativo. 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 passata dal driver 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.
Osservazioni
Per informazioni su quando un driver UMDF usa CreateWdfFile per gestire le operazioni di I/O, vedere Creazione di un oggetto file per gestire idi 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 Impedire uno squilibrio di creazione e chiusura delle notifiche a un driver.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.5 |
| intestazione | wudfddi.h (include Wudfddi.h) |
| dll | WUDFx.dll |