enumerazione WDF_REQUEST_TYPE (wudfddi_types.h)

Articolo
08/08/2023

[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 info, vedi Introduzione con UMDF.]

L'enumerazione WDF_REQUEST_TYPE identifica i tipi di richieste di I/O che un oggetto richiesta UMDF può rappresentare.

Sintassi

typedef enum _WDF_REQUEST_TYPE {
  WdfRequestUndefined,
  WdfRequestCreate,
  WdfRequestCleanup,
  WdfRequestRead,
  WdfRequestWrite,
  WdfRequestDeviceIoControl,
  WdfRequestClose,
  WdfRequestUsb,
  WdfRequestOther,
  WdfRequestInternalIoctl,
  WdfRequestTypeNoFormat,
  WdfRequestFlushBuffers,
  WdfRequestQueryInformation,
  WdfRequestSetInformation,
  WdfRequestMaximum
} WDF_REQUEST_TYPE, *PWDF_REQUEST_TYPE;

Costanti


`WdfRequestUndefined` Il tipo dell'oggetto richiesta non è definito.
`WdfRequestCreate` L'oggetto richiesta rappresenta una richiesta di creazione di file. Il driver riceve questo tipo di oggetto richiesta quando un'applicazione apre un dispositivo chiamando la funzione Microsoft Win32 CreateFile . Il framework recapita questo tipo di richiesta, insieme a un oggetto file appena creato (IWDFFile), alla funzione di callback IQueueCallbackCreate::OnCreateFile del driver. Il nuovo oggetto file rappresenta l'handle di file tipizzato HANDLE restituito da CreateFile Win32.
`WdfRequestCleanup` L'oggetto richiesta rappresenta una richiesta di pulizia del file. Il driver riceve questo tipo di oggetto richiesta dopo la chiamata di un'applicazione alla funzione CloseHandle Win32 chiude l'ultimo handle a un oggetto file, ma possibilmente prima che tutte le richieste di I/O in sospeso del file siano state completate o annullate. Il framework recapita questo tipo di richiesta alla funzione di callback IFileCallbackCleanup::OnCleanupFile del driver. Vedere anche WdfRequestClose.
`WdfRequestRead` L'oggetto richiesta rappresenta una richiesta di lettura. Questo driver riceve questo tipo di richiesta di I/O quando un'applicazione chiama la funzione ReadFile o ReadFileEx Win32. Il framework recapita questo tipo di richiesta alla funzione di callback IQueueCallbackRead::OnRead del driver.
`WdfRequestWrite` L'oggetto richiesta rappresenta una richiesta di scrittura. Questo driver riceve questo tipo di richiesta di I/O quando un'applicazione chiama la funzione WriteFile o WriteFileEx Win32 . Il framework fornisce questo tipo di richiesta alla funzione di callback IQueueCallbackWrite::OnWrite del driver.
`WdfRequestDeviceIoControl` L'oggetto richiesta rappresenta una richiesta di controllo di I/O del dispositivo. Questo driver riceve questo tipo di richiesta di I/O quando un'applicazione chiama la funzione DeviceIoControl Win32. Il framework invia questo tipo di richiesta alla funzione di callback IQueueCallbackDeviceIoControl::OnDeviceIoControl del driver.
`WdfRequestClose` L'oggetto richiesta rappresenta una richiesta di chiusura del file. Il driver riceve questo tipo di oggetto richiesta dopo la chiamata di un'applicazione alla funzione CloseHandle Win32 chiude l'ultimo handle a un oggetto file e dopo che tutte le richieste di I/O in sospeso del file sono state completate o annullate. Il framework recapita questo tipo di richiesta alla funzione di callback IFileCallbackClose::OnCloseFile del driver. Vedere anche WdfRequestCleanup.
`WdfRequestUsb` L'oggetto richiesta è stato inviato a una porta USB. Il metodo IWDFRequestCompletionParams::GetCompletedRequestType può restituire questo valore.
`WdfRequestOther` Questo valore è riservato solo per uso interno.
`WdfRequestInternalIoctl` Questo valore è riservato solo per uso interno.
`WdfRequestTypeNoFormat` Il tipo dell'oggetto richiesta non è stato specificato.
`WdfRequestFlushBuffers` L'oggetto richiesta rappresenta una richiesta di scaricamento dei buffer memorizzati nella cache. Il framework recapita questo tipo di richiesta alla funzione di callback IQueueCallbackDefaultIoHandler::OnDefaultIoHandler .
`WdfRequestQueryInformation` L'oggetto richiesta rappresenta una richiesta per ottenere informazioni su un file. Il framework recapita questo tipo di richiesta alla funzione di callback IQueueCallbackDefaultIoHandler::OnDefaultIoHandler .
`WdfRequestSetInformation` L'oggetto richiesta rappresenta una richiesta per impostare informazioni su un file. Il framework recapita questo tipo di richiesta alla funzione di callback IQueueCallbackDefaultIoHandler::OnDefaultIoHandler .
`WdfRequestMaximum` Viene superato il valore massimo per l'enumerazione .