IoCsqInitializeEx-Funktion (wdm.h)

Die IoCsqInitializeEx Routine initialisiert die Verteilertabelle für eine abbruchsichere IRP-Warteschlange.

Syntax

NTSTATUS IoCsqInitializeEx(
  [out] PIO_CSQ                       Csq,
  [in]  PIO_CSQ_INSERT_IRP_EX         CsqInsertIrp,
  [in]  PIO_CSQ_REMOVE_IRP            CsqRemoveIrp,
  [in]  PIO_CSQ_PEEK_NEXT_IRP         CsqPeekNextIrp,
  [in]  PIO_CSQ_ACQUIRE_LOCK          CsqAcquireLock,
  [in]  PIO_CSQ_RELEASE_LOCK          CsqReleaseLock,
  [in]  PIO_CSQ_COMPLETE_CANCELED_IRP CsqCompleteCanceledIrp
);

Parameter

[out] Csq

Zeiger auf die IO_CSQ Struktur, die von IoCsqInitializeExinitialisiert werden soll.

[in] CsqInsertIrp

Zeiger auf die treiberdefinierte CsqInsertIrpEx--Funktion für die abbruchsichere IRP-Warteschlange des Treibers.

[in] CsqRemoveIrp

Zeiger auf die treiberdefinierte CsqRemoveIrp--Funktion für die abbruchsichere IRP-Warteschlange des Treibers.

[in] CsqPeekNextIrp

Zeiger auf die treiberdefinierte CsqPeekNextIrp-Funktion für die abbruchsichere IRP-Warteschlange des Treibers.

[in] CsqAcquireLock

Zeiger auf die treiberdefinierte CsqAcquireLock--Funktion für die abbruchsichere IRP-Warteschlange des Treibers.

[in] CsqReleaseLock

Zeiger auf die treiberdefinierte CsqReleaseLock--Funktion für die abbruchsichere IRP-Warteschlange des Treibers.

[in] CsqCompleteCanceledIrp

Zeiger auf die vom Treiber definierte CsqCompleteCanceledIrp--Funktion für die abbruchsichere IRP-Warteschlange des Treibers.

Rückgabewert

IoCsqInitializeEx- gibt STATUS_SUCCESS bei Erfolg oder den entsprechenden Fehlercode beim Fehler zurück.

Bemerkungen

Die IoCsqInitialize und IoCsqInitializeEx Routinen initialisieren eine IO_CSQ Struktur, die die abbruchsichere IRP-Warteschlange eines Treibers beschreibt. Sie können IoCsqInitializeEx- verwenden, um eine IRP-Warteschlange mit erweiterten Funktionen anstelle einer von IoCsqInitializeangegeben anzugeben:

• Der Treiber implementiert eine CsqInsertIrpEx- Routine anstelle einer CsqInsertIrp- Routine. CsqInsertIrpEx einen zusätzlichen Parameter verwendet, InsertContext. Wenn der Treiber IoCsqInsertIrpEx- aufruft, um das IRP einzufügen, gibt er den Wert an, der als InsertContext-übergeben wird.
• IoCsqInsertIrpEx- gibt den Rückgabewert CsqInsertIrpExzurück. Treiber können den Rückgabewert verwenden, um anzugeben, ob ein Einfügevorgang erfolgreich war oder fehlgeschlagen ist.

Beachten Sie, dass IoCsq-Xxx- Routinen die DriverContext-[3] des IRP-Elements verwenden, um IRP-Kontextinformationen zu enthalten. Treiber, die diese Routinen verwenden, um IRPs in die Warteschlange zu stellen, müssen dieses Mitglied nicht verwenden.

Anforderungen

Siehe auch

CsqAcquireLock-

CsqCompleteCanceledIrp-

CsqInsertIrp-

CsqInsertIrpEx

CsqPeekNextIrp

CsqReleaseLock-

CsqRemoveIrp

IO_CSQ

IO_CSQ_IRP_CONTEXT

IoCsqInitializeEx

IoCsqInsertIrp-

IoCsqInsertIrpEx-

IoCsqRemoveIrp

IoCsqRemoveNextIrp