Funzione StorPortQueueWorkItem (storport.h)

  • Articolo

StorPortQueueWorkItem accoda un elemento di lavoro Storport da eseguire nel contesto di un thread di lavoro di sistema (kernel).

Sintassi

ULONG StorPortQueueWorkItem(
  [in]           PVOID        HwDeviceExtension,
  [in]           PHW_WORKITEM WorkItemCallback,
  [in]           PVOID        Worker,
  [in, optional] PVOID        Context
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore bus host (HBA).

[in] WorkItemCallback

Puntatore a una routine di callback dell'elemento di lavoro fornita dal miniport. Questa routine viene chiamata nel contesto del thread di sistema per elaborare l'elemento di lavoro pianificato a cui punta Worker .

[in] Worker

Puntatore a un buffer opaco per l'elemento di lavoro allocato e inizializzato restituito da StorPortInitializeWorker.

[in, optional] Context

Contesto facoltativo per il ruolo di lavoro elaborato dalla routine di callback in WorkItemCallback.

Valore restituito

La routine StorPortQueueWorkItem restituisce uno dei codici di stato seguenti:

Codice restituito Descrizione
STOR_STATUS_BUSY L'elemento di lavoro è già in coda per l'elaborazione.
STOR_STATUS_INVALID_DEVICE_STATE L'elemento di lavoro non può essere accodato perché il dispositivo è in fase di rimozione.
STOR_STATUS_INVALID_IRQL Il runtime di integrazione corrente è maggiore di DISPATCH_LEVEL.
STOR_STATUS_INVALID_PARAMETER HwDeviceExtension, Worker o WorkItemCallback è NULL.
STOR_STATUS_SUCCESS L'elemento di lavoro è stato accodato correttamente.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows 8 e versioni successive di Windows.
Piattaforma di destinazione Universale
Intestazione storport.h (include Storport.h)
IRQL <= DISPATCH_LEVEL

Vedi anche

HwStorWorkItem

StorPortFreeWorker

StorPortInitializeWorker