funzione WDF_IO_QUEUE_CONFIG_INIT (wdfio.h)

Articolo
03/22/2025

[Si applica a KMDF e UMDF]

La funzione WDF_IO_QUEUE_CONFIG_INIT inizializza la struttura di WDF_IO_QUEUE_CONFIG di un driver.

Sintassi

void WDF_IO_QUEUE_CONFIG_INIT(
  [out] PWDF_IO_QUEUE_CONFIG       Config,
  [in]  WDF_IO_QUEUE_DISPATCH_TYPE DispatchType
);

Parametri

[out] Config

Puntatore alla struttura WDF_IO_QUEUE_CONFIG del conducente.

[in] DispatchType

Enumeratore WDF_IO_QUEUE_DISPATCH_TYPE che identifica il tipo di invio delle richieste per la coda.

Valore restituito

Nessuno

Osservazioni:

I driver devono chiamare WDF_IO_QUEUE_CONFIG_INIT quando si crea una coda di I/O gestita dall'alimentazione che non è la coda predefinita di un dispositivo. La funzione WDF_IO_QUEUE_CONFIG_INIT zero la struttura WDF_IO_QUEUE_CONFIG specificata e ne imposta il membro Size. Imposta inoltre il membro PowerManaged su WdfUseDefault e archivia il tipo di invio specificato nel membro DispatchType.

A partire da KMDF versione 1.9, se DispatchType è impostato su WdfIoQueueDispatchParallel, WDF_IO_QUEUE_CONFIG_INIT imposta il membro NumberOfPresentedRequest s della struttura su -1. Questo valore indica che il framework può recapitare un numero illimitato di richieste di I/O al driver.

Esempi

Nell'esempio di codice seguente viene inizializzata WDF_IO_QUEUE_CONFIG struttura e quindi viene chiamato WdfIoQueueCreate.

WDF_IO_QUEUE_CONFIG  queueConfig;
NTSTATUS  status = STATUS_SUCCESS;
WDFQUEUE  readQueue;

WDF_IO_QUEUE_CONFIG_INIT(
                         &queueConfig,
                         WdfIoQueueDispatchManual
                         );
status = WdfIoQueueCreate(
                          hDevice,
                          &queueConfig,
                          WDF_NO_OBJECT_ATTRIBUTES,
                          &readQueue
                          );