NetConfigurationQueryBinary 函式 (netconfiguration.h)
擷取目前指派給指定登錄值的數據、將數據儲存在架構配置的緩衝區中,並建立架構記憶體物件來表示緩衝區。
語法
NTSTATUS NetConfigurationQueryBinary(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING ValueName,
[_In_] POOL_TYPE PoolType,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
[_Out_] WDFMEMORY *Memory
);
參數
[_In_] Configuration
NETCONFIGURATION 物件的句柄,表示已開啟的登錄機碼。
[_In_] ValueName
包含值名稱 之UNICODE_STRING 結構的指標。
[_In_] PoolType
POOL_TYPE型別值,指定要配置給數據緩衝區的記憶體類型。
[_In_opt_] MemoryAttributes
包含新記憶體物件之物件屬性 之WDF_OBJECT_ATTRIBUTES 結構的指標。 此參數是選擇性的,而且可以 WDF_NO_OBJECT_ATTRIBUTES。
[_Out_] Memory
接收新記憶體物件句柄之位置的指標。 架構會配置此記憶體緩衝區,並在 NETCONFIGURATION 物件關閉時自動釋放它。
傳回值
如果作業成功,函式會傳回STATUS_SUCCESS。 否則,此函式可能會傳回適當的NTSTATUS錯誤碼。
備註
用戶端驅動程式會呼叫 NetAdapterOpenConfiguration 或 NetConfigurationOpenSubConfiguration,以取得 NETCONFIGURATION 物件的句柄。
當 NETCONFIGURATION 物件關閉時,架構會自動釋放此函式所配置的記憶體。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
最小 KMDF 版本 | 1.21 |
最低UMDF版本 | 2.33 |
標頭 | netconfiguration.h (包含 netadaptercx.h) |
IRQL | PASSIVE_LEVEL |