Funzione IoWMIAllocateInstanceIds (wdm.h)

Articolo
02/27/2024

La routine IoWMIAllocateInstanceIds alloca uno o più ID istanza univoci al GUID.

Sintassi

NTSTATUS IoWMIAllocateInstanceIds(
  [in]  LPCGUID Guid,
  [in]  ULONG   InstanceCount,
  [out] ULONG   *FirstInstanceId
);

Parametri

[in] Guid

Puntatore al GUID per il quale generare identificatori di istanza.

[in] InstanceCount

Specifica il numero di identificatori di istanza da specificare.

[out] FirstInstanceId

Puntatore all'identificatore della prima istanza che il driver deve usare.

Valore restituito

IoWMIAllocateInstanceIds restituisce un codice di stato dall'elenco seguente:

Codice restituito	Descrizione
STATUS_SUCCESS	Indica che WMI ha fornito correttamente identificatori di istanza univoci per il GUID specificato.
STATUS_UNSUCCESSFUL	Indica che i servizi WMI non sono disponibili.
STATUS_INSUFFICIENT_RESOURCES	Indica che sono state disponibili risorse insufficienti per fornire al chiamante ID istanza.

Commenti

Se è stata richiesta più di un'istanza in InstanceCount e la routine è stata completata correttamente, FirstInstanceId punta alla prima istanza che il chiamante deve usare. Per ogni istanza richiesta oltre una, il chiamante deve aumentare il valore restituito in *FirstInstanceId. Ad esempio, se il chiamante ha richiesto sei istanze e una è stata restituita come valore firstInstanceId, il chiamante deve usare i valori 1-6 come identificatori di istanza univoci.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Vedi anche

IoWmiSuggestInstanceName

Condividi tramite