Função ChangerGetProductData (mcd.h)
ChangerGetProductData manipula os aspectos específicos do dispositivo de um IRP de controle de dispositivo com o código IOCTL IOCTL_CHANGER_GET_PRODUCT_DATA.
Sintaxe
NTSTATUS ChangerGetProductData(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
Parâmetros
[in] DeviceObject
Ponteiro para o objeto do dispositivo que representa o alterador.
[in] Irp
Ponteiro para o IRP.
Valor de retorno
ChangerGetProductData sempre retorna STATUS_SUCCESS.
Observações
Essa rotina é necessária.
ChangerGetProductData retorna dados do produto para um alterador.
O driver de classe do alterador verifica o comprimento do buffer de saída no local da pilha de E/S antes de chamar ChangerGetProductData. Se o tamanho do buffer de saída for menor que tamanho de(CHANGER_PRODUCT_DATA), o driver de classe do alterador retornará com um valor de STATUS_INFO_LENGTH_MISMATCH
ChangerGetProductData preenche uma estrutura de CHANGER_PRODUCT_DATA em irp –> AssociatedIrp.SystemBuffer antes de retornar ao driver de classe do changer. Se o driver de miniclasse tiver armazenado em cache dados de investigação na extensão do dispositivo do alterador antes de retornar de ChangerInitialize, todos os membros, exceto DeviceType poderão ser preenchidos com base nesses dados.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | mcd.h (include Mcd.h, Ntddchgr.h) |
| IRQL | PASSIVE_LEVEL |