Função ScsiPortWmiGetInstanceName (scsiwmi.h)

  • Artigo

A rotina ScsiPortWmiGetInstanceName retorna um ponteiro para o nome da instância associado ao SRB ( Windows Management Instrumentation ) SCSI Request Block (WMI) indicado.

Nota O driver de porta SCSI e os modelos de driver de miniporta SCSI podem ser alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar os modelos de driver storport e driver de miniporto Storport .
 

Sintaxe

PWCHAR ScsiPortWmiGetInstanceName(
  [in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);

Parâmetros

[in] RequestContext

Ponteiro para uma estrutura do tipo SCSIWMI_REQUEST_CONTEXT que contém o contexto de solicitação para um SRB WMI.

Retornar valor

Ponteiro para uma cadeia de caracteres contada que contém o nome da instância associado ao SRB indicado. Se o tipo SRB for aquele que não usa um nome de instância, ScsiPortWmiGetInstanceName retornará NULL.

Comentários

O parâmetro RequestContext aponta para uma estrutura de contexto de solicitação, SCSIWMI_REQUEST_CONTEXT, que contém informações associadas a um bloco de solicitação SCSI ( Instrumentação de Gerenciamento do Windows ) (SRB). A estrutura de contexto de solicitação, por sua vez, contém uma das Estruturas de WNODE_XXX WMI usadas pelo sistema WMI para passar dados entre consumidores de dados no modo usuário e provedores de dados no modo kernel, como drivers.

A estrutura WNODE_XXX contida no contexto de solicitação contém um nome de instância associado ao SRB do WMI. O driver de miniporto chama ScsiPortWmiGetInstanceName para extrair esse nome de instância do contexto de solicitação.

A memória alocada para o contexto de solicitação deve permanecer válida até que o driver de miniporto chame ScsiPortWmiPostProcess e ScsiPortWmiPostProcess retorne o status SRB final e o tamanho do buffer. Se o SRB puder ser pendente, a memória do contexto de solicitação deverá ser alocada da extensão SRB. Se o SRB não puder ser pendente, a memória poderá ser alocada de um quadro de pilha que não sai do escopo.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho scsiwmi.h (inclua Miniport.h, Scsi.h)

Confira também

SCSIWMI_REQUEST_CONTEXT

WNODE_ALL_DATA

WNODE_SINGLE_INSTANCE