Função ScsiPortWmiGetInstanceName (scsiwmi.h)
A rotina ScsiPortWmiGetInstanceName retorna um ponteiro para o nome da instância associado ao SRB (Bloco de Solicitação de SCSI) do de Gerenciamento do Windows (WMI).
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 de um SRB WMI.
Valor de retorno
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.
Observações
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 (de Instrumentação de Gerenciamento do Windows) do (SRB). A estrutura de contexto de solicitação, por sua vez, contém um dos estruturas de WNODE_XXX WMI que é usado 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 de 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 ScsiPortWmiPostProcesse ScsiPortWmiPostProcess retornar 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 saia do escopo.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | scsiwmi.h (inclua Miniport.h, Scsi.h) |