共用方式為

IoAllocateDriverObjectExtension 函式 （wdm.h）

  • 發行項

IoAllocateDriverObjectExtension 例程會配置個別驅動程式內容區域，稱為 驅動程式物件延伸模組，並將唯一標識符指派給它。

語法

NTSTATUS IoAllocateDriverObjectExtension(
  [in]  PDRIVER_OBJECT DriverObject,
  [in]  PVOID          ClientIdentificationAddress,
  [in]  ULONG          DriverObjectExtensionSize,
  [out] PVOID          *DriverObjectExtension
);

參數

[in] DriverObject

與內容區域相關聯之驅動程序物件的指標。

[in] ClientIdentificationAddress

指定要配置之內容區域的唯一標識符。

[in] DriverObjectExtensionSize

指定要配置之內容區域的長度，以位元組為單位。

[out] DriverObjectExtension

完成時，所配置內容區域的指標。

傳回值

IoAllocateDriverObjectExtension 會傳回下列其中一個 NTSTATUS 程式代碼：

傳回碼 描述
STATUS_SUCCESS
 指出例程配置了所要求大小的延伸。
STATUS_INSUFFICIENT_RESOURCES
 表示無法為驅動程式物件延伸模組配置記憶體。
STATUS_OBJECT_NAME_COLLISION
 指出具有指定 ClientIdentificationAddress 的驅動程式物件延伸模組已存在。

言論

系統為驅動程式物件延伸模組配置的記憶體是常駐記憶體，而且可從任何 IRQL 存取。 刪除驅動程式物件時，I/O 管理員會自動釋放配置的記憶體。

此例程的呼叫端必須提供 ClientIdentificationAddress的唯一標識符。 若要擷取內容區域的指標，呼叫端會將 ClientIdentificationAddress 傳遞至 IoGetDriverObjectExtension。

要求

要求 價值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平臺 普遍
標頭 wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h）
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

另請參閱

IoGetDriverObjectExtension