Windows System Software -- Consulting, Training, Development -- Unique Expertise, Guaranteed Results
The free OSR Learning Library has more than 50 articles on a wide variety of topics about writing and debugging device drivers and Minifilters. From introductory level to advanced. All the articles have been recently reviewed and updated, and are written using the clear and definitive style you've come to expect from OSR over the years.
Check out The OSR Learning Library at: https://www.osr.com/osr-learning-library/
Upcoming OSR Seminars | ||
---|---|---|
OSR has suspended in-person seminars due to the Covid-19 outbreak. But, don't miss your training! Attend via the internet instead! | ||
Kernel Debugging | 16-20 October 2023 | Live, Online |
Developing Minifilters | 13-17 November 2023 | Live, Online |
Internals & Software Drivers | 4-8 Dec 2023 | Live, Online |
Writing WDF Drivers | 10-14 July 2023 | Live, Online |
Comments
Hi guys, I need help in this project too. Can someone tell me where to implement IOCTL.
Where to implement WHAT ioctl? How much have you done? What do you have working already?
Tim Roberts, [email protected]
Providenza & Boekelheide, Inc.
I am relatively new to this as well. I want the driver to record and play live audio instead of Sine wave. I am finding it difficult to progress. I read the previous comments and tried following it but I haven't got any further. I need some help on which places to change codes.
That doesn't make sense. The virtual driver has no connection at all to "live audio". You can capture the speaker output from an application, but the microphone data has to be fed in from an external application.
This is a difficult project, and not a good place for a beginner.
Tim Roberts, [email protected]
Providenza & Boekelheide, Inc.
Hi,
I have decoded PCM data that I want to feed to virtual microphone, using SYSVAD i have created virtual mic,but I dont understand how to feed the data to virtual mic, may I know which class in sysvad to change for the same ,
**basically I have captured (using WASAPI) audio data that I want to redirect to virtual microphone, instead of playing using speaker
**
need help.....thanks in advance
Note: is virtual speaker really required to feed the data to virtual mic....plz suggest i am new to this
Welcome to the forum! First, this is a "necro-post", which is a term describing bringing a thread back from long ago ... best to create an entirely new thread asking specifically what you're running into ("How do I send audio data to the virtual microphone in SysVAD" or something similar. Next, this topic has been asked and answered a number of times, so use the handy "search" function at the top right for "SysVAD" and you'll run into what others have found. Finally, SysVAD fills a ring buffer from the microphone, in the example using a sine wave function ... you will need to do the same, pushing data from [wherever] into the ring buffer which is then used by the Audio Engine ...
Do some searching, then see if that helps out a bit ...
Hi Tim_Roberts ,
inside AddDevice function i have added
ntStatus = IoRegisterDeviceInterface(
PhysicalDeviceObject,
&RPC_IOCTL_AUDIO,
NULL,
&referenceIOCtlString
);
after that do I need to create call IoCreateSymbolicLink or not required.
or: where and how to create symbolic link in sysvad example??? plz help i am stuck with this
Hi ,
my createfile function returns INVALID_HANDLE_VALUE,
hDev = CreateFile(
(LPCSTR)DeviceInterfaceList,
GENERIC_READ | GENERIC_WRITE,
0,
NULL,
OPEN_EXISTING,
FILE_SHARE_READ|FILE_SHARE_WRITE,
NULL
);
i have below code in place:
inside driverentry:
DriverObject->MajorFunction[IRP_MJ_CREATE] = IoctlCreateClose;
DriverObject->MajorFunction[IRP_MJ_CLOSE] = IoctlCreateClose;
definition:
NTSTATUS IoctlCreateClose(In DEVICE_OBJECT* DeviceObject,
_Inout IRP* _Irp)
{
UNREFERENCED_PARAMETER(_DeviceObject);
}
in output console i am getting
\?\ROOT#MEDIA#0001#{4d36e96c-e325-11ce-bfc1-08002be10318}/////////DeviceInterfaceList value
fail to open device (0x2)/////how to resolve this
hello All,
need your help on above post,
plz i am totally stuck on this, not able to find the reason why my CreateFile api gives ERROR_FILE_NOT_FOUND , while the value of device interface is \?\ROOT#MEDIA#0001#{4d36e96c-e325-11ce-bfc1-08002be10318}
Please do let me know if u need any more input inorder to understand my issue
Not required.
Is that actually a GUID? That's a very strange name for a Device Interface GUID.
And WHERE do you want to access the device from? In user mode, you lookup the GUID using CM_Get_Device_Interface_List
None of the code that you posted makes much sense to me... I don't feel like I've got the full picture of what you're trying to do, where, and how...
Peter
Peter Viscarola
OSR
@OSRDrivers
You don't need to call
IoCreateSymbolicLink
, but you do need to callIoSetDeviceInterfaceState
to turn it on.That's the Media class GUID. Your driver should already be registered there. How did you define
RPC_IOCTL_AUDIO
? Where didDEVICE_SYMBOLIC_LINK
come from in your driver code?Also, you need to remember that you are going to see IRP_MJ_CREATE calls both from your test application AND from the Audio Engine. Audio Engine opens many file handles into an audio device: some for the filter while it's probing, some for the filter while it is operating, and some for each of the pins, where the traffic really flows. You need to check in your "create" handler whether it is a request from your app or not. If it is, you handle it and complete it. If not, you pass it to
PcDispatchIrp
.If you were looking for the fastest way to generate a blue screen, this is it. Do you really not understand what's going on here at all?
PcDispatchIrp
tells the Port Class driver to handle this request using its normal processing. It's going to go through it's own "create" processing, then it will complete the request. Since you have already completed, it, BANG, blue screen. You need to ONE or the OTHER. Never both. If you handle the IRP, then you don't let Port Class see it. If you don't handle it, then you pass it to Port Class.Tim Roberts, [email protected]
Providenza & Boekelheide, Inc.
DEFINE_GUIDSTRUCT("4d36e96c-e325-11ce-bfc1-08002be10318", RPC_IOCTL_AUDIO);
define RPC_IOCTL_AUDIO DEFINE_GUIDNAMED(RPC_IOCTL_AUDIO)
in user application:
GUID guid = { 0x4d36e96c, 0xe325, 0x11ce, 0xbf, 0xc1, 0x8, 0x0, 0x2b, 0xe1, 0x3, 0x18 };
// char* DevicePath = NULL;
PZZSTR DeviceInterfaceList = NULL;
ULONG DeviceInterfaceListLength = 0;
// WCHAR DeviceInterfaceList[4096];
//DeviceInterfaceList = (PZZSTR)malloc(DeviceInterfaceListLength);
DeviceInterfaceList = (PZZSTR)HeapAlloc(
GetProcessHeap(),
HEAP_ZERO_MEMORY,
DeviceInterfaceListLength * sizeof(WCHAR));
_tprintf(_T("%s\n"), (LPCSTR)DeviceInterfaceList);
HANDLE hDev = INVALID_HANDLE_VALUE;
DeviceInterfaceList value is : \?\ROOT#MEDIA#0001#{4d36e96c-e325-11ce-bfc1-08002be10318}
but Createfile returns ERROR_FILE_NOT_FOUND//////need help on this
Hi,
my device is already registered at 4d36e96c-e325-11ce-bfc1-08002be10318 in registry,
define IOCTL_NT_DEVICE_NAME L"\Device\RemotePCVad"
UNICODE_STRING referenceIOCtlString;
DEFINE_GUIDSTRUCT("4d36e96c-e325-11ce-bfc1-08002be10318", RPC_IOCTL_AUDIO);
define RPC_IOCTL_AUDIO DEFINE_GUIDNAMED(RPC_IOCTL_AUDIO)
I think since i am using
RtlInitUnicodeString(&referenceIOCtlString, IOCTL_NT_DEVICE_NAME);
so Symbolinclink is not required, I will remove DbgPrint("Handle to symbolink link %wZ opened", DEVICE_SYMBOLIC_NAME); code from IoctlCreateClose function
but why Createfile returns ERROR_FILE_NOT_FOUND;
my testapp code:
GUID guid = { 0x4d36e96c, 0xe325, 0x11ce, 0xbf, 0xc1, 0x8, 0x0, 0x2b, 0xe1, 0x3, 0x18 };/
// strncpy_s(DevicePath, DeviceInterfaceListLength,DeviceInterfaceList, DeviceInterfaceListLength);
//StringCchCopy(DevicePath, DeviceInterfaceListLength, DeviceInterfaceList);
///printf(L"%s\n", (const char*)DeviceInterfaceList);
errNum = GetLastError();//////errNum value is 2/////this is issue i am facing
in registry i can see my device registered under:
Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\DeviceClasses{4d36e96c-e325-11ce-bfc1-08002be10318}##?#ROOT#MEDIA#0001#{4d36e96c-e325-11ce-bfc1-08002be10318}
How to know who(user app or audio engine) calls IRP_MJ_CREATE
That GUID does not belong to you. That's a Microsoft GUID, and exposing it makes other promises. You need to create your own GUID for your own private interface.
All of the casts you are doing make me suspicious that you've made a rookie mistake. You shouldn't have to cast any of that. Just for now, you should throw out the
_tprintf
and use straightputs
to make absolutely sure you're getting an ANSI string, and not a Unicode string. Get rid of any casts where you are passing that variable to other APIs. If you get compilation errors, then you are mixing character sets, which is disastrous. That's especially true forCreateFile
. If you have to cast the file name to get it intoCreateFile
, then you have made a mistake.It's tricky, The most common way is to add a reference string when you create your device interface, and look for that reference string in the file name field when you get the IRP_MJ_CREATE call.
Is your create handler getting called at all? I'm guessing it isn't, because you would have seen a blue screen. Does your device appear in Device Manager as a sound device?
Tim Roberts, [email protected]
Providenza & Boekelheide, Inc.
Hi Tim,
You are right, i have seen bluescreen issue, but my device appear in device manager, and also i can see the virtual mic in my sound control panel, the only issue i am facing is blue screen(thats bcz of PCDispatcher as u mentioned in create function) and CreateFile error.
for CreateFile i removed all the casting:
GUID guid = {0x4d36e96c, 0xe325, 0x11ce, 0xbf, 0xc1, 0x8, 0x0, 0x2b, 0xe1, 0x3, 0x18 };
CONFIGRET cr;
PWSTR DeviceInterfaceList = NULL;
ULONG DeviceInterfaceListLength = 0;
plz help me to resolve 'function': incompatible types - from 'PWSTR' to 'PZZSTR' error in CM_Get_Device_Interface_List function
That GUID i have added in INF file .
Is it complaining about
Just make sure the wprintf prints something readable.
PZZSTR
, or aboutPZZWSTR
? If it is complaining about PZZSTR, then you have somehow mixed up your APIs, because it means you have the ANSICM_Get_Device_Interface_List
and the UnicodeCreateFile
. If it is complaining about PZZWSTR, then I will allow you to insert a cast to eliminate that warning.Why? It doesn't need to be there. And it's STILL not your GUID.
Tim Roberts, [email protected]
Providenza & Boekelheide, Inc.
It was complaining about PZZSTR that too inside CM_Get_Device_Interface_List.
GUID guid = { 0x4d36e96c, 0xe325, 0x11ce, 0xbf, 0xc1, 0x8, 0x0, 0x2b, 0xe1, 0x3, 0x18 };
if I declare DeviceInterfaceList as LPTSTR instead of PWSTR its compiling and , value of DeviceInterfaceList also gettingprinted as
\?\ROOT#UNNAMED_DEVICE#0001#{4d36e96c - e325 - 11ce - bfc1 - 08002be10318}
is it fine???
It was complaining about PZZSTR that too inside CM_Get_Device_Interface_List ,
then I changed the variable DeviceInterfaceList type from PWSTR to LPTSTR
GUID guid = { 0x01ee4b4f, 0x6fb0, 0x4763, 0xa8, 0x43, 0x41, 0x55, 0x91, 0xf1, 0xf0, 0x1 };
got DeviceInterfaceList as \?\ROOT#UNNAMED_DEVICE#0001#{01ee4b4f-6fb0-4763-a843-415591f1f001}
Is it fine , need your approval
You don't need MY approval, you need WINDOWS' approval. Does your CreateFile call get into the driver now?
Tim Roberts, [email protected]
Providenza & Boekelheide, Inc.
that i still need to check.
but one more help i already asked, need solution
NTSTATUS IoctlCreateClose(In DEVICE_OBJECT* DeviceObject,
_Inout IRP* _Irp)
{
UNREFERENCED_PARAMETER(_DeviceObject);
}
how to knoe that user application calls this api, so that in that case i can avoid PcDispatchIrp
without PcDispatchIrp call here, i couldnot see virtual mic in sound control panel, how to proceed for now
Hi Tim,
For now i have only added PcDispatchIrp and commented IoCompleteRequest(_Irp, IO_NO_INCREMENT); part in IRP_MJ_CREATE handler function still my CreateFile returns FILE_NOT_FOUND error number 2.
some bug in my code that you can only identify sir.
Any help on above post....thanks in advance
Hi Tim,
inside IRP_MJ_CREATE handler function for now i commented PcDispatchIrp(_DeviceObject, _Irp);
with that Createfile is working, but i am not able to see virtual device sound control panel.
while it is visible in device manager.
so plz help me how i can have both PcDispatchIrp(_DeviceObject, _Irp); and IoCompleteRequest(_Irp, IO_NO_INCREMENT); in IRP_MJ_CREATE handler. under condition that when user app call IRP_MJ_CREATE it should skip PcDispatchIrp(_DeviceObject, _Irp);
NTSTATUS IoctlCreateClose(In DEVICE_OBJECT* DeviceObject,
_Inout IRP* _Irp)
{
UNREFERENCED_PARAMETER(_DeviceObject);
}
my createfile is working now,after commenting pcdispatcher from IRP_MJ_CREATE handler, but i want PCDispatcher also,how to do that
I did tell you that earlier in the thread. Port Class uses the file name in the IRP_MJ_CREATE IRP to decide what kind of open it is. You can dump those file names in the debugger to see what they look like. You can add a reference string to your device interface, and that reference string will be passed as the file name. If you use a custom reference string, then you can identify when the open comes from your application.
Tim Roberts, [email protected]
Providenza & Boekelheide, Inc.
Hi Tim,
Plz give some clue on above post.
Hi Tim,
I have one doubt, you have mentioned about "add a reference string to your device interface"
Is it the same reference string which we pass inside
UNICODE_STRING device_sym_link = RTL_CONSTANT_STRING(L"\Device\RemotePCVadDevice");
UNICODE_STRING device_ref_string = RTL_CONSTANT_STRING(L"RemotePCVadDevice");
ntStatus = IoRegisterDeviceInterface(
PhysicalDeviceObject,
&RPC_IOCTL_AUDIO,
&device_ref_string,/////////////////are u talking about this??????plz clarify
&device_sym_link
);
if yes then we can use
const auto IsUserSpaceAppRequest =
!RtlCompareUnicodeString(&device_ref_string
, &IrpStack->FileObject->FileName
, TRUE);
to identify the call inside IRP_MJ_CREATE
In CreateFile I am passing "\?\ROOT#MEDIA#0007#{4d36e96c-e325-11ce-bfc1-08002be10318}\RemotePCVadDevice" as file name
plz clarify.
Yes, that's it. I don't remember whether the driver gets a leading "\" or not; you'll have to do some debug prints to verify that.
Tim Roberts, [email protected]
Providenza & Boekelheide, Inc.
Hi Tim,
over the TCP connection I am receiving encoded mic output from source application ,at target app i am decoding the audio data , now
I have decoded audio data(using AAC) in my target application, that I want to redirect to virtual audio mic(earlier i was playing it using SDL player). do I need to store that decoded data again in ring buffer within the driver code??,
I can transfer that decode data to driver using IOCTL, but there I will receive inside driver.cpp custom IOCTL handler, from custom IOCTL handler how can I transfer the data to MiniportWaveRTStream::WriteBytes and copy it to m_pDmaBuffer. plz help with some sample code snippet.
VOID MiniportWaveRTStream::WriteBytes
(
In ULONG ByteDisplacement
)
/*++
Routine Description:
This function writes the audio buffer using a sine wave generator
Arguments:
ByteDisplacement - # of bytes to process.
--*/
{
}
if i have to feed my audio buffer to m_pDmaBuffer , do i need to write that much code inside WriteBytes(mentioned above), except
memcpy(m_pDmaBuffer ,my audio buffer received USING IOCTL, length)????
plz need your help.
Any suggestion on above post.