PGET_LOCATION_STRING função de retorno de chamada (ntddk.h)
A rotina de PnpGetLocationString fornece a parte específica do dispositivo da propriedade SPDRP_LOCATION_PATHS do dispositivo.
Sintaxe
PGET_LOCATION_STRING PgetLocationString;
NTSTATUS PgetLocationString(
[in, out] PVOID Context,
[out] PZZWSTR *LocationStrings
)
{...}
Parâmetros
[in, out] Context
Um ponteiro para informações de contexto específicas da interface. O chamador passa o valor passado como o Context membro da estrutura PNP_LOCATION_INTERFACE.
[out] LocationStrings
Um ponteiro para uma sequência de cadeias de caracteres Unicode terminadas em nulo, que é encerrada por outro zero. Cada cadeia de caracteres serve como uma cadeia de caracteres de localização para o dispositivo. Normalmente, os drivers retornam uma única cadeia de caracteres.
Valor de retorno
A rotina retorna um valor NTSTATUS para indicar o status da operação.
Observações
A estrutura PNP_LOCATION_INTERFACE fornece um ponteiro para a rotina de PnpGetLocationString.
A rotina de PnpGetLocationString fornece a parte específica do dispositivo da cadeia de caracteres de localização para o dispositivo. O gerenciador do Plug and Play (PnP) monta a cadeia de caracteres de localização de um dispositivo consultando o driver do dispositivo, o barramento do dispositivo e todos os ônibus pai e concatenando as cadeias de caracteres fornecidas juntas.
A rotina deve retornar uma cadeia de caracteres exclusiva para o dispositivo em relação ao seu barramento. A cadeia de caracteres deve ser a mesma para o dispositivo em todas as versões do sistema operacional. Depois de selecionar uma cadeia de caracteres para essa finalidade, você não deverá alterá-la.
Por convenção, a cadeia de caracteres de localização assume o formulário ServiceName(BusSpecificLocation). Por exemplo, os dispositivos PCI usam PCI(XXYY), onde XX é o número do dispositivo e YY é o número da função.
A rotina de PnpGetLocationString chama uma rotina como ExAllocatePoolWithTag para alocar a memória para a cadeia de caracteres de localização. O chamador é responsável por chamar a rotina ExFreePool para liberar a memória apontada por LocationStrings quando a cadeia de caracteres de localização não for mais necessária.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows Server 2003. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ntddk.h (inclua Ntddk.h, Ntifs.h) |
| IRQL | <= PASSIVE_LEVEL |